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How to Use This Manual 


Overview 


Utilities Reference gives you essential information about NetWare® utilities. 
For more information about each utility, see the online help for that utility. 


For step-by-step instructions to accomplish specific tasks, see Supervising the 
Network or other manuals or online help that apply to your task. For 
information on NetWare terminology and concepts, see Concepts . 


Some new utilities have been included with NetWare 4™ . Some NetWare 
utilities have been discontinued, while others have been combined with related 
utilities. 


Before you can work effectively with NetWare 4 utilities, you must understand 
basic information about Novell® Directory Services™ . See Guide to NetWare 
4 Networks . 


In Novell documentation, an asterisk denotes a trademarked name belonging to 
a third-party company. Novell trademarks are denoted with specific trademark 
symbols, such as ™. 
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chapter 
1 Command Syntax 


This section explains the command syntax used in NetWare® documentation. 
The following MAP example illustrates several syntax conventions: 


MAP [P | NP] [option ] drive := [drive :|path ] 


After typing the command line, press Enter to execute the command. 


Table 1-1Command Syntax 


Convention 





Boldface 
characters 


Italicized 
characters 


... (ellipses) 


[] 


igi 





Explanation 


Boldface characters indicate items that you type at the 
prompt, such as commands. 


Italicized characters indicate variables that you replace 
with information pertinent to your task. 


Ellipses indicate that parameters, options, or settings 
can be repeated. 


An item enclosed in square brackets is optional. You can 
enter the command with or without the item. 


Items enclosed by nested square brackets are optional, 
but if you use the items within the innermost brackets, 
you must also use the items within the outer brackets. 


When items are separated by a delimiter bar, you can 
use either item, but not both. 


Braces indicate that you must choose at least one of the 
enclosed options. 


Angle brackets enclose a descriptive name for any value 
that is provided as output by a computer. 
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ABORT REMIRROR 








Purpose 
Use at the server console to stop remirroring a logical partition. 
Syntax 
ABORT REMIRROR [number ] 
Parameter Use to 
number Specify the number of the logical partition you 
want to stop remirroring. 
To view a list of disk partitions, execute the MIRROR STATUS command. See 
“MIRROR STATUS” on page 138 
Example 


To stop remirroring logical partition 2, type 


ABORT REMIRROR 2 


Additional Information 


Topic See 





Restart remirroring “REMIRROR PARTITION” 


Chapter 2: Utilities 3 


ACTIVATE SERVER 


ACTIVATE SERVER 





Purpose 
Use at the server console to 
@ Load the MSEngine for the NetWare 4 SFT III system™ . 
@ Synchronize the memory of both SFT III servers. 
@ Remirror the disks from one SFT III server to the other. (The SFT II 
server where you type ACTIVATE SERVER becomes the primary 


server.) 


@ Execute MSSTART.NCF and MSAUTO.NCF. 





Syntax 
ACTIVATE SERVER [parameter ...] 
Parameter Use to 
-na Prevent running the MSAUTO.NCF file you 


created in INSTALL. This parameter is useful if 
you are changing commands in MSAUTO.NCF. 


-ns Prevent executing the MSSTART.NCF file you 
created in INSTALL. This parameter is useful if 
you want to change the boot process. 


Both (-na -ns) Load the MSEngine without executing 
MSAUTO.NCF or MSSTART.NCF. 


Using ACTIVATE SERVER 


@ You must execute MSERVER before using this utility. 
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If the MSAUTO.NCF file does not exist, ACTIVATE SERVER 
prompts you for an MSEngine name and an IPX™ internal 
network number. 


Putting ACTIVATE SERVER in the IOSTART.NCF file might cause 
synchronization problems. 


If both servers execute ACTIVATE SERVER simultaneously, the 
utility might load two separate, unsynchronized MSEngines, and 
both servers would assume the primary server role. 


Chapter 2: Utilities 5 


ADD NAME SPACE 





ADD NAME SPACE 


Purpose 


Use at the server console to store non-DOS files on a NetWare® volume. 


Before you can use this command, you must load a name space module. See 
“LOAD” 


Syntax 


ADD NAME SPACE [name 


[TO [VOLUME]] volume_name ] 





Parameter 


Use to 





(no parameter) 


name 


volume_name 


Using ADD NAME SPACE 
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Display the loaded name spaces. 


Specify the name of the name space module 
you loaded. Supported names are 


MAC (Macintosh) 

LONG (OS/2, Windows 95/98, Windows NT) 
NFS (NFS) 

FTAM (FTAM) 


FTAM is an add-on module that you can 
purchase from another provider. 


Specify the name of the volume you want to 
store the non-DOS files on. 





@ You only need to add a name space to a volume once by using the 
ADD NAME SPACE command. 


Each time you mount a volume to which you added a name space 
(for example, each time you bring up the server), the 
corresponding name space module is autoloaded. 


ADD NAME SPACE 





Since you don’t need to add a name space to a volume each time the server 
comes up, you don’t need to put the ADD NAME SPACE command in the 
AUTOEXEC.NCF file. 


@ When name space support is added to a volume, another entry is 


created in the directory table for the directory and file naming 
conventions of that name space (file system). 


Additional Information 





Topic See 





Adding name space support Setting Up a Volume to Store Non-DOS Files 
in Supervising the Network . 
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ADDICON 





Purpose 
From a workstation running Microsoft* Windows* 3.1x , use ADDICON at the 
DOS prompt or in login scripts to add icons to a Windows 3.1x Program 
Manager group. This utility modifies the existing group (.GRP) file to add the 
icon to the group’s view. 
Syntax 
ADDICON {parameter... | @scriptfile } [/H] 
Parameter Use to 
ICON=filename Specify the file containing the icon, if 


different from the executable file. 


EXE=filename Specify the name of the executable 
file. 
DESC=tex t Specify a description of the 


executable file. 


Default: Executable filename. 


CMD=parameters Specify any command-line 
parameters required by the 
executable file. 


WORK<=directory Specify the working directory of the 
executable file. 
MIN=YES, NO Set the minimize flag. 
Default: NO. 
GROUP=groupname Specify the name of the program 


group to modify. 
Default: Startup. 


8 Utilities Reference 


ADDICON 





Using ADDICON 


Parameter 





Use to 





WINDOWS=path 


GROUPFILE=filename .GRP 


Specify the Windows directory path. If 
you do not specify a path, ADDICON 
searches the PATH environment 
variable for WIN.COM. 


Specify the name of the .GRP file to 
update. Use this parameter in place of 
GROUP and WINDOWS. 








@scripttile Specify a script file that contains all 
the needed parameters. If you use 
@scriptfile , do not use the other 
parameters. 

Option Use to 

/H View online help. All parameters are 


ignored when /H is used. 


@ ADDICON does not create a new program group. 


@ ADDICON does not replace an existing icon with a new one. 


@ ADDICON does not distinguish differences in the Windows 3.1x , 
Windows 95/98*, and Windows NT* versions of WIN.COM. If 
you have multiple Windows operating systems installed on your 
computer, be sure to specify a Windows directory path that leads 
to the WIN.COM file you want. 
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AFP 


Purpose 
Load the AppleTalk* Filing Protocol (AFP) module on the server to allow 
Macintosh users to share files and applications with network users of other 
platforms. 

Syntax 
LOAD AFP 

Using AFP 


After loading AFP.NLM, use the AFPCON utility to configure the AFP 
module. 
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ALIAS 


Purpose 


Syntax 


Examples 


Use at the server console to define a keyword to represent text. When you type 
the keyword at the command line, the server replaces the word with the text. 
The text can include spaces and punctuation. 


The keyword remains in effect until you restart the server. 


If you are associating a keyword with a command string, be sure that you do not 
inadvertently leave out the keyword. If you do leave out the keyword, the first 
word in the command string becomes the keyword. If you then try to execute the 
command, the server will interpret it as a keyword, not as a command. 


For example, if you enter ALIAS LOAD INSTALL, LOAD becomes a keyword for 


INSTALL. If you then try to execute a LOAD command, the server displays ??? 
Unknown command ???. 


ALIAS [keyword [text ]] 








Parameter Use to 

(no parameter) Display all defined aliases and the text they 
represent. 

keyword and text Assign the keyword to the text. 

keyword Delete the keyword as an alias for the text. 


In the following example, ALIAS is used to associate the keyword proto with 
a command to bind a protocol. 


ALIAS PROTO BIND IPX NE3200 NET=12345678 
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ALIAS 





To use the keyword, you would enter the following at the server console 
prompt, instead of the BIND command: 


PROTO 
Executing ALIAS with no parameter would display the following: 


1. PROTO alias for <BIND IPX NE3200 NET =12345678> 











To delete the keyword, you would enter the following at the server console 
prompt: 


ALIAS PROTO 
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ATCON 





ATCON 


Purpose 


Syntax 


Using ATCON 


ATCON Menu Options 


Use at the server console to 


+ 


+ 


Monitor the activity of AppleTalk* network segments 
Examine the configuration of the local AppleTalk router 


Diagnose operational problems in network segments that support 
AppleTalk 


Verify the connectivity of an AppleTalk router to the rest of the 
internetwork 


Monitor the status of AppleTalk Update-based Routing Protocol 
(AURP) 


LOAD ATCON 


When you load ATCON, an Available Actions menu appears. You access 
ATCON features from this menu. Menu options are shown in the following 


table. 


Option Use to 





AURP Information View the status of the Internetwork Protocol 


(IP) Tunnel for AURP and its peers. (Available 
only if AURP is enabled.) 
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ATCON 
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Option Use to 

Interfaces View addressing information about interfaces 
directly connected to the AppleTalk router. 

Log Files Set logging levels for AppleTalk messages. 


Lookup Network Entities 


Packet Statistics 


Protocol Configuration 


Routing Table 


View NetWare system log and volume log files. 


Query for services available on the AppleTalk 
network. 


View statistics maintained by the AppleTalk 
router. 


View the configuration of the AppleTalk 
protocol stack. This is a read-only screen. 


View the AppleTalk router’s Routing Table 
Maintenance Protocol (RTMP) table. This table 
lists all destinations the AppleTalk router can 
reach. 





ATOTAL 





ATOTAL 








Purpose 
Use at a workstation to total the accounting charges on your network. 
Syntax 
ATOTAL [destination path\filename ] [/C] 
[/? | /VER] 

Parameter Use to 

destination path Redirect the output of ATOTAL to a file. 

/filename 

/C Scroll continuously through the report of 
accounting charges. 

/? View online help. All other parameters are 
ignored when /? is used. 

/VER View the version number of the utility and the 
list of files it uses to execute. All other 
parameters are ignored when /VER is used. 

Using ATOTAL 


@ You must have access to the SYS:SYSTEM directory of the server 
you want information for. (You can either run ATOTAL from the 
SYS:SYSTEM directory, or have a search drive mapped to it.) 


@ You must have the Supervisor object right on the server. 


@ Accounting must be activated before ATOTAL so that ATOTAL 
has access to the data file accounting creates (NET$ACCT.DAT). 


@ Use ATOTAL to display the accounting information for a server. 
ATOTAL displays the following information for each day: 
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ATOTAL 





+ Connect time 

e Blocks read 

+ Blocks stored per day 
e Server requests 


+ Blocks written 


Examples 


@ To redirect the output of ATOTAL to a file named ACCT on C:, 
type 


ATOTAL >C:\ACCT 
@ To scroll the display continuously, type 


ATOTAL /c 


Additional Information 


Topic See 





Accounting Accounting in Concepts . 
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AUDITCON 


Purpose 

Use at DOS workstations to allow an auditor to configure and review the 

server’s volume and container audit trails. 

Options available at the initial AUDITCON screen are 

@ Audit directory services 

@ = External auditing 

@ Change current server 

@ Change current volume 

@ Enable volume auditing 
Syntax 


AUDITCON [/VER] 


Parameter Use to 





/VER View the version number of the utility and the 
list of files it uses to execute. 





For help with tasks, press <F1> in the utility. 


Using AUDITCON 


@ AUDITCON allows individuals, acting independently of 
network supervisors and others, to audit network transactions. 


@ Auditors can audit Novell Directory Services™ (NDS) events and 
those events specific to a volume’s file system or server. 
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AUDITCON 





File system auditing is enabled at the volume level; NDS™ 
auditing is enabled at the container level. 


Auditors can track network events and activities, but they can’t 


open or modify files (other than audit data and audit history files) 
unless they are granted appropriate rights by the network 


supervisor. 


Additional Information 


18 Utilities Reference 


Topic 


See 





Auditing 


Using AUDITCON 


Volume auditing 


Container auditing 


External audit trails 


Auditing in Concepts 
Auditing the Network 


Using the AUDITCON Utility in Auditing the 
Network 


Using AUDITCON for Volume Auditing in 
Auditing the Network 


Using AUDITCON for Container Auditing in 
Auditing the Network 


Using AUDITCON to Audit External Audit Trails 
in Auditing the Network 





BIND 





BIND 


Purpose 


@ Use at the server console to link a communication protocol to a 
network board and its LAN driver. Unless you link the protocol to 
the board, the board can’t process packets. 


@ — You can also use either INETCFG or INSTALL to link the network 
boards and their LAN drivers to the communication protocols. 
See “INETCFG” or Loading and Binding LAN Drivers in 
Supervising the Network . 


Before you bind a protocol to a network board and LAN driver, you must install 
the network board and load the LAN driver. 


Syntax 


BIND protocol [TO] lan driver | board name [driver 
parameter ...] [protocol parameter ...] 


Bind Parameters 


Parameter Use to 





protocol Specify the communication protocol. 


lan driver | board name Specify either the LAN driver name or the 
network board name. 
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BIND 








Parameter 


Use to 





driver parameter 


protocol parameter 


Driver Parameters 


Identify a particular network board. 


If you specified a network board name, you do 
not need to specify driver parameters. 


If you specified a LAN driver and your server 
has more than one instance of the LAN driver 
loaded, use a driver parameter to specify the 
particular board the driver is running. 


For alist of valid driver parameters, see “Driver 
Parameters” 


Specify the protocol parameters required for 
the protocol you are binding. See “Protocol 
Parameters” 


Depending on your system, one or more of the following parameters can be 
used to identify a particular board. 





Parameter 


Use to 





DMA=number 


FRAME=number 


INT=number 


MEM=number 


PORT=number 
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Specify the DMA channel for the board. Use 
the same channel number you did when you 
loaded the driver. 


Specify the frame type for the board. Use the 
same type you did when you loaded the driver. 


Specify the interrupt number for the board. Use 
the same interrupt number you did when you 
loaded the driver. 


Specify the memory address for the board. Use 
the same memory address you did when you 
loaded the driver. 


Specify the I/O port for the board. Use the 
same I/O port number you did when you 
loaded the driver. 


BIND 








Parameter 


Use to 





SLOT=number 


NODE=number 


Specify the network board by the lot it was 
installed in. Use this parameter with 
microchannel and EISA computers. Specify 
the same slot number you used when you 
loaded the driver. 


Specify the node address for the board. This is 
a 12-digit hexadecimal number. 





Protocol Parameters 





Protocol/Parameter 


Use to 





For IPX protocol: 
NET=number 


Specify the IPX external network number. This 
is the number of the cabling system attached to 
the board. 


If the board is attached to an existing cabling 
system, use the same IPX external network 
number as used by other boards of the same 
frame type attached to this cabling system. Do 
not use the same number that was used by 
boards of a different frame type. 


If the board is attached to a new cabling system 
or if itis the first board of its frame type 
attached to the cabling system, you can enter 
any hexadecimal number of up to eight digits, 
as long as the number is different from all other 
network numbers. (See Network numbering in 
Concepts.) 


Remember that all boards of the same frame 
type attached to the same cabling system must 
use the same IPX external network number for 
that cabling system. 
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Using BIND 





Protocol/Parameter Use to 





For other protocols: Specify the information required by the 


, particular protocol. 
Refer to the documentation 


that comes with the protocol 
and consult NetWire® or 
your Novell Authorized 
Reseller™ . 


@ You may not need to use the BIND command unless you want to 
add new LAN drivers after the initial server installation. 


@ You can use INSTALL to load LAN drivers and bind them with 
the IPX protocol or nonrouting TCP/IP or AppleTalk protocols. 
INSTALL places the BIND commands in the AUTOEXEC.NCF file 
after you load the LAN drivers. Then each time the server comes 
up, the LAN drivers are automatically bound to the protocols. 


@ — You can also use INETCFG to load and bind LAN drivers. 
INETCFG places the BIND statements in the INITSYS.NCF file. 


@ Ifyou use only the IPX/SPX protocol, you can add the BIND 
statement to the AUTOEXEC.NCF file. 


Additional Information 
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Topic See 





Binding a protocol to a driver “INETCFG” 


Loading and Binding LAN Drivers in 
Supervising the Network 


Viewing a list of “PROTOCOL” 
communication protocols 


Loading LAN drivers “LOAD” 





BRGCON 





BRGCON 


Purpose 
Use at the server console to view the following managed objects implemented 
through Simple Network Management Protocol (SNMP) on your NetWare for 
OS/2* bridge: 
@ Basic bridge configuration information 
@ Spanning tree information for the bridge 
@ Transparent bridging information 
@ Port information and statistics, including spanning tree 
configuration, source route bridge configuration, and transparent 
bridge configuration 
@ Interfaces table 
Syntax 


LOAD BRGCON 


Using BRGCON 


@ When you load BRGCON, an Available Options menu appears. 
You access BRGCON features from this menu. 


The menu options are: 
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BRGCON 
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Option Use to 
SNMP Access Select a bridge to monitor. 
Configuration 


View Configuration 
Spanning Tree Information 


Transparent Bridging 
Information 


Ports 


Interfaces 


You can monitor the local system (the default), 
or you can monitor a remote system by using 
IPX or TCP/IP. 


You can also set the poll interval to specify how 
often the information is retrieved through 
SNMP. 


View basic bridge configuration information. 
View spanning tree protocol information. 


View information about transparent bridging, or 
view the Filtering/Forwarding table. 


View a list of active ports for the bridge. (View 
information about a port by selecting it.) 


You can also access source route, transparent, 
and spanning tree per port information. 


View a list of supported network interfaces. 
(View information about an interface by 
selecting it.) 





BRGCON also lets you set some objects through SNMP, such as 


+ The label and priority of the spanning tree 


+ The maximum age, hello time, and forward delay of the 
spanning tree when it is the root bridge 


+ The aging time of the transparent bridge 


Generally, the local NetWare node is the target of BRGCON. 


However, you can access any bridge that implements the 
Management Information Base (MIB) bridge by using BRGCON. 
This can be done over UDP/IP or IPX transports. 


BROADCAST 





BROADCAST 


Purpose 
The SEND console command has the same functionality as the BROADCAST 
command from NetWare 3. (The BROADCAST command is also available in 
NetWare 4.) 


See “SEND” 
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CAPTURE 





Purpose 


Use at a workstation to set printer and printing parameters for applications’ use. 


Syntax 


CAPTURE [P=printer | Q=queue ] L=number [/option 


.] 
[/? | /VER] 


Additional Information 


Topic See 





Using CAPTURE Using CAPTURE in Print Services . 
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CD 





CD 


Purpose 


Syntax 


Use at the server console to monitor and administer a CD-ROM disc used as a 
NetWare volume. 


CD is available only after you have loaded CDROM. If you use CD without 
CDROM loaded, you will get an Unknown command error message. 


CD parameter 








Parameter Use to 
HELP Display help information for CD. 
MOUNT Mount a CD-ROM volume. 


For more information on using this parameter 
and its options, see “MOUNT Parameter” 


DEVICE LIST List CD-ROM devices. 
For more information, see “DEVICE LIST 
Parameter” 

VOLUME LIST List volumes identified on CD-ROM devices. 
For more information, see “VOLUME LIST 
Parameter” 

DISMOUNT Dismount a CD-ROM volume. 
For more information, see “DISMOUNT 
Parameter” 

CHANGE Change the mounted media in a CD-ROM 
drive. 


For more information, see “CHANGE 
Parameter” 
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CD 





Using CD 


HELP Parameter 
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Parameter Use to 

RENAME Rename a CD-ROM volume. 
For more information, see “RENAME 
Parameter” 

DIR View the contents at the root level of a CD- 
ROM volume. 


For more information, see “DIR Parameter” 
GROUP Assign a NetWare trustee group. 
List defined groups and their group numbers. 


For more information, see “GROUP 
Parameter” 


PURGE Purge hidden index and cache files created by 
CD-ROM volumes. 


For more information, see “PURGE 
Parameter” 


IMAGE Mount a CD-ROM image file as a CD. Mounting 
the image lets you test the image before 
making a master CD. 


For more information, see “IMAGE Parameter” 


The following subsections describe the use of each CD command parameter. 


To display information about the CD command and its parameters and options, 
type 


CD HELP 


There are several pages to the help display; repeat the CD HELP command to 
see each page. 


CD 





MOUNT Parameter 


To mount a CD-ROM volume, type 


CD MOUNT {object number | volume name } [/name space ] 


[/option ...] 


Specify either the object number or volume name. The mounted 
CD-ROM volume names must be unique. 


To determine the object number or volume name, execute either 
CD DEVICE LIST or CD VOLUME LIST. Both commands display 
CD-ROM volume names. The volume name is found in a column 
labeled Volume Name and the object number is found in a column 
labeled No. 


Supported name spaces: NFS and Macintosh. To add Macintosh 
name space support, use /MAC. To add NFS* name space 
support, use /NFS. 


If the name space module isn’t loaded, the volume with the 
specified name space support won't mount. 


CD MOUNT Options 





Option Use to 





/R 


Rebuild the index file for a CD-ROM volume. 
For example, use this option when remounting 
a volume if you are changing its name space 
support since the last time you mounted it 
(either adding or deleting name space 
support). 


Important: If you don’t rebuild the index file, 
the parameters you used the first time you 
mounted the volume will be used. 


If you erroneously enabled block suballocation 
or turned on file compression and 
subsequently corrupted the data, use this 
command to rebuild the volume’s index file. 
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CD 
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Option 





Use to 





/l 


IX 


/G = group number 


/dup 


/all 


Mount a volume even if importing errors are 
found and only some files on the CD-ROM disc 
are available. 


Exclude one or more directories on the CD- 
ROM. For example, to exclude the DOS 
directory that is at the root of the CD-ROM (and 
any subdirectories beneath it), type 


CD MOUNT 3 /X=DOS 


To reestablish access to the excluded directory, 
remount the volume with the /R option to 
rebuild the index file. 


Assign a predefined group to the volume. This 
gives the group members all access rights to 

the volume. The default is group EVERYONE 
(group 0). You don’t need to assign this value. 


To view existing group numbers or to set anew 
group number, use the CD GROUP command. 
See “GROUP Parameter” 


Check for duplicate patterns on filenames in 
the same directory. 


Mount or dismount all of the CD-ROM volumes. 





CD 





Option 





Use to 





/DNVC=number 


/ANVC=number 


Add Direct Map caching to a CD volume when 
creating a new index during the mount process. 


This caching method allows information from 
the CD to be cached on the hard drive, 
providing faster recall. Of the three caching 
options (/DNVC, /ANVC, /LNVC), Direct Map 
caching provides the fastest performance, but 
information won't remain in the cache as long 
as with the other options. 


The number is the number of megabytes that 
will be used as a nonvolatile cache. This space 
is created on the same volume that holds the 
current indexes. 


Be sure there is enough space on the selected 
index volume. 


This option cannot be used with any other 
caching option. 


Add Set Associative caching to a CD volume 
when creating a new index during the mount 
process. 


This caching method allows information from 
the CD to be cached on the hard drive, 
providing faster recall. Of the three caching 
options (/DNVC, /ANVC, /LNVC), Set 
Associative caching provides a medium level of 
performance. 


The number is the number of megabytes that 
will be used as a nonvolatile cache. This space 
is created on the same volume that holds the 
current indexes. 


Be sure there is enough space on the selected 
index volume. 


This option cannot be used with any other 
caching option. 
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CD 











Option Use to 

/LNVC=number Add Associative (LRU) caching to a CD volume 
when creating a new index during the mount 
process. 


This caching method allows information from 
the CD to be cached on the hard drive, 
providing faster recall. Of the three caching 
options (/DNVC, /ANVC, /LNVC), Associative 
(LRU) caching provides slower performance, 
but information will remain in the cache longer 
than with the other options. 


The number is the number of megabytes that 
will be used as a nonvolatile cache. This space 
is created on the same volume that holds the 
current indexes. 


Be sure there is enough space on the selected 
index volume. 


This option cannot be used with any other 
caching option. 


When a CD-ROM disc is being mounted or changed, CD-ROM devices are 
deactivated so device configuration information can be updated. 


DEVICE LIST Parameter 


This parameter displays the list of CD-ROM devices, as shown in Figure 2-1 . 


Figure 2-1 
CD-ROM Device List 


CD ROM Device List 
No. Act. Device Name Vol Name Mounted 
9 Y Device #1 SONY CDROM CDU-541 (5D000000 ALR_DISC Y 


Devices are listed in groups of 10. Repeat the command to display the next 
group of 10 devices. 
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CD 





Information on the Device List 


@ No. (Media Manager object number): Identifies each CD-ROM 
device. 


The object number can be used in the CD MOUNT and 
DISMOUNT commands. (This number is not the same as the SCSI 
ID associated with this device or the device number.) 


The Media Manager object number is hereafter called object number . 


@ Act. (Active status): Indicates whether the CD device is active. 


@ Device Name: Indicates the number of the device and lists 
hardware-specific information about the CD device. 


@ — Vol. Name: Indicates the name of the CD volume that is 
established when the CD-ROM label is scanned by the device. 


@ Mounted: Indicates whether the volume is mounted. 


VOLUME LIST Parameter 


To list volumes identified on CD-ROM devices that the system knows about, 
type 

CD VOLUME LIST 

Volumes are listed in groups of 10. Repeat the command to display the next 
group of 10 volumes. The list includes the following for each volume: object 
number, volume name, and mounted device name. For a definition of these 


terms, see “DEVICE LIST Parameter” 


The CD VOLUME LIST command doesn't display information for devices 
that don't have media present. 


DISMOUNT Parameter 


To dismount a CD-ROM volume, type 
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CD 





CHANGE Parameter 
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CD DISMOUNT {object number | volume name } [option... ] 


After CD DISMOUNT is executed, all system resources are returned to the 
system. 


CD DISMOUNT Options 


Option Use to 





/eject Eject the CD-ROM disc from the 
device after the volume has been 
dismounted. 


/purge Allow the index file for the volume to 
be removed when the volume is 
dismounted. 





To change the media in a CD-ROM drive, type 


CD CHANGE {object number | volume name } 
[/name space ] [/option ]] 


@ Specify either the object number or volume name. 


+ Using name space parameters is optional. To add name space 
support, enter the /MAC or /NFS name space, or use both name 
spaces. 


@ The CHANGE parameter has the same options as the MOUNT 
parameter, plus the /purge option of the DISMOUNT parameter. 
For a description of valid options, see “MOUNT Parameter” and 
“DISMOUNT Parameter” 


The CD CHANGE command dismounts the volume. Then you are prompted 
to replace the media. 


Don’t remove a CD that is mounted until you’re prompted to do so. After you 
remove the CD, replace it with a new disc. Wait for it to completely spin up and 


CD 





RENAME Parameter 


DIR Parameter 


GROUP Parameter 


then press <Enter> . If you do not wait for the disc to spin up, an error will occur 
and the media will not be mounted 


The media is mounted as a NetWare volume with the options you set. 


Use the CD RENAME command when you have multiple CD-ROM discs with 
the same volume name. The system will not allow you to mount multiple 
volumes with the same name. 


To view the names of mounted volumes, use the CD RENAME command with 
no parameter. 


You must dismount the volume before you can rename it. 
To rename the CD-ROM volume, type 
CD RENAME /D = object number new_volume_name 


Enter the object number and the new volume name. This new name is assigned 
to the volume. 


CD DIR allows you to view the contents at the root level of aCD-ROM 
volume. (Each CD-ROM is treated as one volume for NetWare access.) 


To view the contents of a root directory, type 
CD DIR {object number | volume name } 
Specify either the object number or the volume name 


Directory entries are listed in DOS format. 


Because CD-ROM volumes are not part of the Directory tree, you cannot 
assign trustees to them in the standard way. 
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The GROUP parameter allows you to associate a predefined group with a CD- 
ROM volume, thus giving the members of the group access rights to the 
volume. 


First, you create a group within the Directory tree and assign members to it, 
using standard NetWare utilities such as NetWare Administrator. Do not assign 
any trustee rights to the group. By default, the group receives all access rights 
to the volume. 


Then, use the GROUP parameter to assign a group number to the predefined 
group. To assign a group number, type 


CD GROUP [group_name ] [group_number ] 
@ Replace group_name with the group name defined in the 
Directory. The group name must not have any spaces in it. Replace 
group_number with a group number (1 through 9). You can assign 


numbers in any order. 


@ By default, group EVERYONE is group zero (0). You do not need 
to assign this group a number. 


When you mount a CD-ROM volume, use the /G option to associate the group 
number with the volume. This gives the members of the group all access rights 
to the volume and prevents anyone else, other than the Administrator, from 


accessing the volume. See “MOUNT Parameter” 


Only one group can have access rights to a CD-ROM volume at a time. The 
default group is EVERYONE. 


You can also use the GROUP parameter to list defined groups with their group 
numbers and to delete a group from the list. 


To see a list of groups and group numbers, type 
CD GROUP 
To delete a group, type 


CD GROUP DEL group_number 


CD 





PURGE Parameter 


IMAGE Parameter 


Use the CD PURGE command to purge hidden index and cache files created 
by CD-ROM volumes. (If you mount many different CD-ROM discs, hidden 
index files can accumulate and take up disk space.) 

Dismount all CD-ROM volumes before executing the CD PURGE command. 
To purge index files for all CD-ROM volumes, type 


CD PURGE 


The IMAGE parameter lets you mount a CD image as a standard CD so you 
can test the image before creating a master CD. 


The image must be a sector-by-sector bit image of a CD-ROM disc. If the 
image is not a sector-by-sector bit image, it will not mount successfully. 


The following CD IMAGE commands are available: 


CD IMAGE server_pathname :image_filename 
CD IMAGE LIST 

CD IMAGE DEL ID_number 

CD IMAGE MOUNT ID_number 

CD IMAGE DISMOUNT ID_number 


CD IMAGE Commands 








Command Use to 
CD IMAGE server_pathname Add this CD image to the active list of 
:image_filename CD images. 
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CD 








Command 


Use to 





CD IMAGE LIST 


CD IMAGE DEL /D_number 


CD IMAGE MOUNT /D_number 


CD IMAGE DISMOUNT /D_number 





Additional Information 


Topic 


Display the list of all active CD 

images. Each CD device is identified 

by a hexadecimal number, which is 

the image ID number. For example: 
IMAGE FILE: 1A2B3C4D 














Use this number where required in 
other CD IMAGE commands. 


Remove a CD image from the list of 
active images. 


To determine the ID number, execute 
the CD IMAGE LIST command. The 
ID number is the hexadecimal 
number shown as part of the CD 
device name. 


Mount a CD image as a CD. 


To determine the ID number, execute 
the CD IMAGE LIST command. The 
ID number is the hexadecimal 
number shown as part of the CD 
device name. 


Dismount a CD image that has been 
mounted as a CD. 


To determine the ID number, execute 
the CD IMAGE LIST command. The 
ID number is the hexadecimal 
number shown as part of the CD 
device name. 





Mounting and using a CD- 
ROM as a volume 
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Using CD-ROM as a NetWare Volume in 
Supervising the Network. 


CD 








Topic See 





AdministeringaCD-ROMas Administering a CD-ROM as a NetWare 


a volume Volume in Supervising the Network. 
Media commands “MEDIA” 


Magazine commands “MAGAZINE” 
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CDROM 


Purpose 


Use at the server console to allow a CD-ROM disc to function as a NetWare 


volume. 


Syntax 


40 


LOAD [path ]CDROM [/option... 


All options are case sensitive. 


] 





Parameter 





path 


/option 


Specify the path to CDROM.NLM if you moved 
it from the default directory. 


Replace option with any available option. 





Option 


Use to 





/H, /h, or /? 


/V=volume_name 


/DISPLAYON 


Display a help screen that explains 
the available options. 


When you use this option, the CD- 
ROM module is not loaded. You must 
execute the LOAD CDROM 
command again. 


Specify a volume to hold the index 
files. Use this option only if you don’t 
want to use the default volume. 


Default: SYS: volume 


Display filenames and a directory and 
file count as the volume is mounting. 
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CDROM 





Using CDROM 


Treat the CD-ROM as a read-only volume. Don’t enable block suballocation or 
use file compression on the volume. These actions corrupt the CD-ROM volume 
index data. 


@ CDROM won't load unless you have loaded the NWPA.NLM 
NPA driver (an I/O device-independent driver that interfaces 
with the Media Manager). 


@ NetWare 4 supports CD-ROM volumes mounted with the MAC 
and NFS name spaces. 


@ CDROM supports High Sierra and ISO 9660 formats. It also 
supports HFS (Apple) file systems with an add-on module called 
HFSLFS.NLM, which is included with the NetWare operating 
system. To enable HFS support, load CDROM and then load the 








HFSLFS module. 
Additional Information 
Topic See 
CD console commands “CD” 
Administering CD-ROM Using a CD-ROM as a NetWare Volume in 
volumes Supervising the Network . 
Media commands “MEDIA” 
Magazine commands “MAGAZINE” 
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CLEAR STATION 


Purpose 


Syntax 


Use at the server console to clear a workstation connection. 


If you use CLEAR STATION while the workstation is in the middle of a 
transaction or a file update, files might be saved with incomplete data. 


CLEAR STATION {n |all} 





Parameter Use to 





n Specify the connection number of the 
workstation you want to clear from the server. 


all Clear all workstation connections to the server. 





Using CLEAR STATION 
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@ To determine the connection number, select Connection 
Information from the MONITOR screen at the server console or 
use NLIST on a workstation. 


@ You can use CLEAR STATION either after a workstation has 
crashed and left files open on a server or before you need to down 
the server. 


@ CLEAR STATION closes the workstation files and erases the 
server's internal tables for the station, including drive mappings 


not saved in the login script. 


@ The communication link between server and station is broken. 


CLEAR STATION 





Additional Information 


Topic See 





Removing server resources Clearing a Workstation Connection in 
from a workstation Supervising the Network . 
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CLIB 


Purpose 
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CLIB.NLM is a library of C functions that provides an ANSI-compliant 
runtime interface for other NetWare Loadable Module™ (NLM) programs. 
You do not need to load CLIB manually because it is autoloaded by any other 
module that needs it. 


The functionality of earlier versions of CLIB has been divided among six 
NLM™ programs, of which the current CLIB.NLM is one. 


The six NLM programs are 


@ FPSM.NLM: A library of functions providing floating-point 
support for NLM programs 


@ THREADS.NLM: A library of functions that constitute the 
NetWare threads package 


@ REQUESTR.NLM: A library of functions that make up the 
NetWare requester 


@ NLMLIB.NLM: A library of functions that provide basic runtime 
support for NLM programs, including POSIX-mandated 
functionality 


@ NIT.NLM: A library of NetWare interface tools needed by some 
NLM programs 


@ =  CLIB.NLM: The standard C runtime library containing ANSI- 
mandated functions 


All six NLM programs are autoloaded by any module that needs them. 


The NetWare operating system requires all six modules, not just CLIB.NLM. If 
you download modules from an online service, be sure to download current 
versions of all the modules, not just CLIB.NLM. 


CLIB 





Using CLIB 


If you receive an error message indicating that a third-party NetWare Loadable 
Module™ (NLM) program is not allowing low-priority processes to run, load 
the NLM using this CLIB option: (CLIB_OPT)/y. This option instructs the 
system to run lower-priority processes as well as higher-priority processes. The 
command syntax is: 


LOAD third-party NLM (CLIB_OPT) /Y 


The parentheses are required. 


Chapter 2: Utilities 45 


CLS 


CLS 





Purpose 


Use at the server console to clear the console screen. (You can also use OFF to 
clear the screen.) 


Syntax 


CLS 
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COLORPAL 


Purpose 


Syntax 


Using COLORPAL 





Active Window Border 

Active Window Text 

Alert Window Text and Border 
Background and Inactive Windows 
Error Window Text and Border 
Help Window Border 


Help Window Text 
Key Description 
Key Name 

Quick Help Area 
Screen Header 
Selection Bar 





COLORPAL [/VER] 


Parameter Use to 


Use at a workstation to change the color of menu elements. The following 
COLORPAL menu shows the elements you can change. 


Change Color On: 








/VER 


For help with tasks, press <F1> in the utility. 


View the version number of the utility and the 
list of files it uses to execute. 





@ Menu elements set with COLORPAL are saved to the 


IBM_RUN.OVL file. By default, the IBM_RUN.OVL file is in the 


SYS:PUBLIC directory. 
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You must have the Write right to the IBM_RUN.OVL file. 
Therefore, a copy of the file must reside in the directory you run 
NetWare text utilities from (including the NMENU utility). 


The colors used by any NetWare text utility are determined by the 
copy of IBM_RUN.OVL found when the utility executes. 


You can have multiple copies of IBM_RUN.OVL in multiple 
directories. Each copy of the overlay file can have different menu 
element settings, providing different menus with varying color 
combinations. 


Unless you set your own color combinations with COLORPAL, 
the colors set by default, or by the network supervisor, will be the 
colors displayed by every NetWare text utility you open. 


CONFIG 





CONFIG 


Purpose 
Use at the server console to view the following: 
@ NetWare server name, internal network number, server uptime, 
and loaded LAN drivers 
@ Hardware settings, node (station) addresses, external network 
number of the cabling scheme, board name, frame type, and 
communication protocol for each network board 
@ The server’s Directory tree and bindery context 
Syntax 


CONFIG 


Using CONFIG 


@ Before installing memory boards, network boards, or host bus 
adapters, execute CONFIG to see a list of hardware settings 
already in use by LAN drivers. 


+ Onsome systems, CONFIG may also display information about 


NetWare Loadable Modules (NLMs). The kind and amount of 
NLM information depends on the system. 


Additional Information 





Topic See 





Internal network numbers Network numbering in Concepts . 


Network numbers for cabling Network numbering in Concepts . 
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Topic 





See 





Node addresses 
Loadable modules 


Configuration information for 
disk drivers 


Network numbers in use by 
your server 


Node number in Concepts . 
“MODULES” and “MONITOR” 


Load the Device Drivers in /nstallation and 
Upgrade 


“MONITOR” 


“DISPLAY NETWORKS” 





CONLOG 





CONLOG 


Purpose 
Use at the server console to 
© Capture all console messages generated at the server while 
CONLOG is loaded 
@ Write the messages to the SYS:\ETC\CONSOLE.LOG default file 
(or to another file of your choice) 
Syntax 


LOAD CONLOG [FILE=log filename ] [SAVE=backup 
filename ] [MAXIMUM=max file size ] [ENTIRE=YES] | 





HELP 

Parameter Use to 

FILE=/og filename Specify the log file you want to use if you don’t 
want CONLOG to write to the default log file 
(CONSOLE.LOG). 
The /og filename parameter is used with SFT 
Ill servers, whose three engines must each 
write to a different log file. 

SAVE=backup file name Specify the filename in which you want to save 


the preexisting console log. 


This parameter enables AUTOEXEC.NCF to 
load CONLOG without overwriting the previous 
console log. Use this parameter if you want to 
examine the old console log for troubleshooting 
purposes. 
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Parameter 


Use to 





MAXIMUM=max file size 


ENTIRE=YES 


HELP 





Using CONLOG 


Specify the maximum size, in kilobytes, of the 
log file. 


If the log file exceeds the max file size , it is 
deleted—or renamed if backup filename was 
specified. In either case, logging starts over 
with an empty log file. 


Capture the lines already on the screen at the 
time CONLOG is loaded. 


Without this parameter, CONLOG starts 
logging with the next output to the console after 
itis loaded. 


View a description of each CONLOG 
command parameter. 


@ You can view the console log from the Internetworking 
Configuration utility INETCFG) or with any text editor. Console 
messages can reveal errors that occur during system initialization. 


Do not use EDIT to view the console log while INETCFG is loaded. 


@ The command LOAD CONLOG is typically added to the 
AUTOEXEC.NCF file, as in the following example: 











NETW41_SVR 








FILE SERVER NAME 

IPX INTERNAL NET C92556! 
LOAD CONLOG 

LOAD REMOTE 

LOAD RSPX 


Examples 





























Gl 


¢ To start capturing console messages during system initialization, 


type 
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LOAD CONLOG 


@  Toload CONLOG but save the current log file as CLOG.BAK and 
limit the size of CONSOLE.LOG to 100 KB, type 


LOAD CONLOG SAVE=CLOG.BAK MAXIMUM=100 
@ To stop capturing console messages, type 


UNLOAD CONLOG 


Additional Information 


Topic See 





INETCFG “INETCFG” 
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CX 


Purpose 


Syntax 


Using CX 
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Use at a workstation to view or change your context, or to view containers and 
leaf objects in your tree structure. 


CX [new context ] 


Parameter 


[/option ...] [/? | /VER] 


To 





(no parameter) 


new context 


/option 


/? 


/VER 


View the current context. 


Move to a new context or specify the context 
you want for an option. 


Replace option with any available option. See 
“CX Options.” 


View online help. All other parameters are 
ignored when /? is used. 


View the version number of the utility and the 
list of files it uses to execute. All other 
parameters are ignored when /VER is used. 


@ CX issimilar to the DOS CD and DIR commands in that CX allows 
you to change contexts and view all objects below a given 


container. 


@ CX doesn’t recognize spaces in object names. If you have spaces in 
container names, put quotation marks around the names or use 
underscores (_) in place of the spaces. 


For example, for container CORPORATE ADMIN, type Corporate 
Admin or Corporate_Admin. 


CX 





CX Options 


Examples 


@ You may need to use CX before logging in to set your context to 
the same value as the name context specified in your NET.CFG 
file. 


Option Use to 





/R List containers at the root level, or change 
context in relation to the root. 


/T List containers below the current context or a 
specified context in a tree structure. 


/CONT List containers at the current context or a 
specified context in a vertical list with no 
structure. 

/A Include all objects at or below the context. Use 
with /T or /CONT. 

/C Scroll continuously through output. 


@ To see your context in the Directory before logging in, type 
CX 


@ Toset anew context from the root 
+e Place a period in front of the new context you type, or 


+ Enter the proper number of trailing periods to reach the root 
level, or 


+ Use the /R option. 
@ To back up one level in the Directory tree, type 


Cx . 
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(You must put a space between the command and the trailing 
period.) 


To go down two levels from PROVO.NOVELL to 
SYSTEM.ENGINEERING. PROVO.NOVELL, type 


CX SYSTEM.ENGINEERING 

To change your current context from TESTING. 
PROVO.NOVELL.US to SYSTEM.MARKETING. 
PROVO.NOVELL.US, type 


CX .SYSTEM.MARKETING.PROVO.NOVELL.US 


or 
CX SYSTEM.MARKETING. 


To change to the root when your context is 
TEST.PROVO.NOVELL, type 


Cx . 


or 
CX /R 


To change the complete context from TESTING. 
PROVO.NOVELL to TESTING.PARIS.NOVELL, type 


CX .TESTING.PARIS .NOVELL 
To show all containers in the current context, type 
CX /CONT 


To show all containers in the context SALES.NOVELL in a tree 
structure, type 


CX .SALES.NOVELL /T 


CX 





@ To show all containers and leaf objects in the current context in a 
tree structure, type 





CX /T /A 
Additional Information 
Topic See 
Context Context in Concepts . 
Root object Root object in Concepts . 
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DHCPCFG 





Purpose 


Use at the server console to manage the NetWare Dynamic Host Configuration 
Protocol (DHCP) service. 


Syntax 


LOAD DHCPCFG 


Additional Information 


Topic See 





Installing or configuring the DHCP Configuring a DHCP Server in 
software NetWare/IP Administrator’s Guide . 
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DISABLE LOGIN 


Purpose 


Use at the server console to prevent users from logging in. 


Syntax 


DISABLE LOGIN 


Using DISABLE LOGIN 


@ Use this command to prevent users from logging in when you are 
making repairs, backing up files, or loading software. 


@ Users already logged in aren't affected. However, a user who logs 


out can’t log in again until you execute ENABLE LOGIN. (See 
“ENABLE LOGIN” on page 71 ) 
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DISMOUNT 


Purpose 


Use at the server console to make a volume unavailable to users. 


Syntax 


DISMOUNT volume name 





Parameter Use to 
volume name Specify the name of the volume you want to 
dismount. 





Using DISMOUNT 


@ DISMOUNT allows you to maintain or repair a volume and to 
upgrade disk drivers while the NetWare server is up. 


@ Use this command to unmount all volumes residing on a 
removable drive before you remove the drive. 


@ Ifyou are running out of memory and can’t add more RAM, 
consider dismounting a volume that isn’t used often. 


Mounted volumes take up memory allocated for file caching and 
thus affect server performance. 


@ — You can also use INSTALL to dismount a volume. 


Additional Information 








Topic See 
Dismounting a volume Mounting and Dismounting Volumes in 
Supervising the Network . 
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DISPLAY NETWORKS 


Purpose 


Use at the server console to list all networks and assigned network numbers that 
the NetWare server’s internal router recognizes. 


Syntax 


DISPLAY NETWORKS 


Using DISPLAY NETWORKS 


DISPLAY NETWORKS lists the IPX external network numbers of networks 
recognized by your server. The following example illustrates a portion of the 
command display: 





0000000D 2/3 00000016 5/11 00000070 5/11 
00000097 6/12 000000ED 5/6 000000F1 3/3 
000000FF 2/2 00000101 6/11 00000111 5/11 
000003E8 5/11 00000456 6/12 00000666 5/17 





Each address is followed by two numbers separated by a slash. The first 
number is the number of hops between your server and the network at that 
address. The second number is the number of ticks (1/18th of a second) 
required to send a packet to that address. 


Additional Information 





Topic See 
Listing servers on the “DISPLAY SERVERS” 
network 





Chapter 2: Utilities 61 


DISPLAY SERVERS 


DISPLAY SERVERS 





Purpose 


Use at the server console to view a list of servers and services being advertised 
by Service Advertising Protocol (SAP) packets. 


Syntax 


DISPLAY SERVERS [string ] 





Parameter Use to 
(no parameter) Display a list of all servers. 
string Specify the name of the server you want to 


display information about. 


The string can include an asterisk (*) as the last 
character. In this case, the system displays a 

list of all servers whose names begin with the 
string. 


For example, DISPLAY SERVERS D* displays 
a list of all servers with names beginning with 
D. 





Using DISPLAY SERVERS 


@ DISPLAY SERVERS lists server address names for services such as 


File services 

Novell Directory Services (NDS) 

Print services 

Storage Management Services™ (SMS) 

Services for Structured Query Language (SQL) servers 


The following illustrates a line of a typical display: 
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MKTSERVER 1 SALES 3 TESTSERVER 0 





@ The number listed after the server name indicates the number of 
hops between your server and the listed server. Your server is 
indicated by 0 hops. 


Servers more than 16 hops away aren't recognized. 


@ DISPLAY SERVERS also displays Directory trees and network 
addresses. A server can be displayed many times, once for each 
service that it advertises. 


For example, all NetWare 4 servers are listed at least two times 
because they advertise file services and Novell Directory Services. 


Additional Information 





Topic See 
Listing networks “DISPLAY NETWORKS” 
Service advertising Service Advertising Protocol in Concepts . 
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DOSGEN 


Purpose 


Syntax 


Use at a workstation to boot a DOS workstation from remote boot image files 
on the server (rather than booting from a local drive). 


DOSGEN [/? | /VER] 


You must first load RPL on the server and bind it to the network board. See the 
Novell Client documentation. 








Parameter Use to 
/? View online help. 
/VER View the version number of the utility and the 


list of files it uses to execute. 





Additional Information 
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Topic See 





Creating remote boot image See the Novell Client documentation. 
files. 





DOWN 





DOWN 


Purpose 
Use at the server console to ensure data integrity before turning off power to 
the NetWare server. 

Syntax 
DOWN 

Using DOWN 


@ DOWN ensures data integrity by writing cache buffers to disk, 
closing files, and updating Directory tables and File Allocation 
Tables. 


@ Changes held in cache buffers are lost if you turn off power 
without using DOWN first. 


Additional Information 








Topic See 

Downing the NetWare Bringing Down a Server in Supervising the 
server Network . 

Restarting the server “RESTART SERVER” 
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DSMERGE 


Purpose 
Use at the server console to 
@ Merge the roots of two separate Novell Directory Services (NDS) 
trees 
@ Rename a tree to verify that all servers in the tree are responding 
properly and have the same tree name 
@ View time synchronization information and display the time 
server for all servers in the tree 
Syntax 


LOAD [path ]DSMERGE 





Parameter Use to 

path Specify the path to DSMERGE.NLM if you 
moved it from the default directory of 
SYS:SYSTEM. 





Additional Information 








Topic See 

Configuring time Maintaining Network Time Synchronization in 

synchronization Supervising the Network 

Merging partitions Merging Partitions in Supervising the Network 

Moving leaf objects Moving Objects in the Directory Tree in 
Supervising the Network 
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DSMERGE 











Topic See 
Using DSMERGE Merging NDS Trees in Supervising the 
Network 
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DSREPAIR 


Purpose 


Syntax 


Use at the server console to repair and correct problems in the NetWare 
Directory Services database, such as records, schema, bindery objects, and 
external references. 


LOAD [path ]DSREPAIR [-U] 





Option Use to 

path Specify the path to DSREPAIR.NLM if you 
moved it from the default directory. 

-U Instruct DSREPAIR to run and exit, and then 
unload from memory, without further user 
assistance. 


Additional Information 
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Topic See 





Using DSREPAIR Repairing the Novell Directory Database in 
Supervising the Network . 





EDIT 





EDIT 


Purpose 


Syntax 


Using EDIT 


Use at the server console to create or modify a text file on either a DOS or 
NetWare partition. 


LOAD [path JEDIT pathname 





Parameter Use to 

path Specify the path to EDIT.NLM if you moved it 
from the default directory. 

pathname Specify the pathname of the file you want to 


edit. 


If you don’t enter a pathname when you load EDIT, EDIT displays 
a dialog box where you can enter the pathname. 


You can also press <Ins> to display a browse window from which 
you can select a file. To see the contents of a volume or directory, 
highlight the volume or directory name in the window and press 
<Enter> . Use the arrow keys to scroll up and down the list of files 
and directories. When the file you want to edit is highlighted, 
press <Enter> to select and display the file. 


If the file doesn’t exist, EDIT displays a prompt asking if the file 
should be created. 


When you create a new file, the file can be no larger than 8 KB. 
Each time you open the file after that, you can increase the file size 


by up to 4 KB. 


You can use EDIT to view read-only files. 
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@ EDIT is particularly useful for creating .NCF batch files that 
automatically execute server commands. 


Additional Information 


Topic See 





Editing or creating text files | Editing Text Files from the Server Console in 
Supervising the Network . 
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ENABLE LOGIN 


Purpose 
Use this command at the server console prompt to 

@  Reenable the login function after using DISABLE LOGIN. 

@ Enable the supervisor account when the account has been locked 
by the intruder detection function. (The supervisor account exists 
only on bindery-based servers or on NetWare 4 servers when 
bindery emulation is active.) 

Syntax 


ENABLE LOGIN 


Using ENABLE LOGIN 


You don’t need to use ENABLE LOGIN when you start the NetWare server or 
workstation. The login function is enabled during the startup process. 
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ENABLE TTS 


Purpose 
Use at the server console to start the Transaction Tracking System™ (TTS) in 
the network server. 

Syntax 
ENABLE TTS 

Using TTS 


Normally, TTS™ is enabled. Use ENABLE TTS only if the TTS has been 
disabled, automatically or manually. 


Do not ever disable TTS intentionally because this will prevent updates to the 
Novell Directory Services replicas on the server. 


Additional Information 





Topic See 

Enabling TTS Protecting Database Integrity with TTS in 
Supervising the Network . 

TTS description Transaction Tracking System in Concepts . 

TTS$LOG.ERR file Keeping a Log of Backed-Out Data in 
Supervising the Network . 
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EXIT 


Purpose 

Use at the server console to return to DOS after you down a network server. 
Syntax 

EXIT 
Using EXIT 


You must use the DOWN command to down the server before using EXIT. 


@ EXIT allows you to access DOS files or to rerun SERVER.EXE with 
new parameters. 


@ Ifyou have removed DOS from the server, using EXIT reboots the 





server. 
Additional Information 
Topic See 
Returning to DOS after Bringing Down a Server in Supervising the 
downing the server Network . 
Restarting the server “RESTART SERVER” 


without rebooting it 
Bringing down the server “DOWN” 


Warm booting the server “REMOVE DOS” 
with EXIT 
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FILER 


Purpose 


Use at a workstation to manage files and directories. FILER works with the file 
system; it doesn’t affect Novell Directory Services objects. 


Figure 2-2 shows the functions of FILER. 
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Figure 2-2 
FILER Functions 


Allows you to: 















e Modify or view files 


e Change current directory or 
server 


e Modify, add, or view directories 


e Modify, add, or view 
subdirectories 


Modify or view rights for files 
and directories 


View trustees for files and 
directories 


Allows you to view files or directories 
according to a search pattern. 
Allows you to set your current 
context, volume object, and new path. 


Allows you to view: 





e Owner 

e Creation date 
e Creation time 
e Volume type 


e Total kilobytes available 
e Maximum directory entries 
e Entries available 


Syntax 


FILER [/VER] 





Available options 


Manage files and directories 
Manage according to search pattern 
Select Current Directory 
View volume information 
Salvage deleted files 
Purge deleted files 

set default filer options 


Allows you to set: 
e Confirmation defaults when 
you modify files 
e File attributes 


e Notification if extended 
attributes are lost 





Allows you to permanently remove 
deleted files from the system. 


Allows you to retrieve deleted files 
that have not been purged. 








Parameter 


Use to 





/VER 


View the version number of the utility and the 
list of files it uses to execute. 
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For help with tasks, press <F1> while you are in the utility. 


Using FILER 


This section describes features of FILER and explains how to use them. 


Using the Browse Screen 
By selecting different items in a list, you can either view or edit an item, or you 


can select a different level of the directory structure to view or edit. Figure 2-3 
shows the main tasks you can perform from the browse screen. 
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Figure 2-3 
The Browse Screen 


Press <Enter> to move to the 
parent directory. 
















































i (parent) 
N (root) 
š (current) 
HELPSCRN (subdi t ) 
Press <Enter> to move to the root TEMP ak direcioni 
level of this volume. SRUN „OVL (file) R 
437-UNI .001 (file) 
ADMIN.CUT (file) 
AXSRUN . OVL (file) 
Press <F10> to manage the CAPTURE . EXE (file) 
current directory CAPTURE .MSG (file) 
i CC .EXE (file) 
CC .MSG (file) 


CMPQSRUN -DUL (file) 






Press <F10> to manage this file. 


Press <Enter> to see the files and 
directories in this subdirectory. 








Press <F10> to manage this 
subdirectory. 





Managing File or Directory Information 


Each file and directory can be managed separately. Figure 2-4 displays the 
various areas you can view or edit. 
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Figure 2-4 
File Information 


This shows DOS This shows 
attributes. NetWare attributes. 


Attributes: [Rw---A] [--------------- 
Owner: CN=Admin.O=NOVELL 
Inherited Rights Filter: [SRWCEMFA] 










This shows whether the file has 
been compressed or migrated. 








Trustees: | <empty> + The arrow indicates that there 
Current effective rights: [SRWCEMFA] can be more than one item for 
Owning name space: DOS this field. 

File size: 938 bytes Press <Enter> on this field to 


EA Size: 0 bytes view the list. 


Creation date: 9-2-1992 

Last accessed date: 9-2-1992 

Last archived date: (Not Archived) 

Last modified date: 9-2-1992 
Restoring Deleted Files or Directories 


To restore deleted files and directories, from the initial menu choose Salvage 
Deleted Files. You can restore only those files you have the Create right for. 


Examples 


Modify File or Directory Attributes 
1. Select Manage Files and Directories. 


2. Highlight the file or directory whose attributes you want to 
modify. Press <F10>. 


3. Select View/Set File (Directory) Information. 


4. Press <Enter> on Attributes. 
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5. Press <F1> for help from here. 


View Volume Information 


1. Select Select Current Directory. 


2. Highlight the volume whose information you want to view. 


Press <F10>. 
3. Select View volume information. 


4. Press <F1> for help from here. 


View File or Directory Effective Rights 


1. Select Manage files and directories. 


2. Highlight the file or directory whose effective rights you want 


to view. Press <F10>. 
3. Select View/Set File (Directory) Information. 
4. Find Current Effective Rights on the form. 


5. Press <F1> for help from here. 


Copy a File or All Files in a Directory 
1. Select Manage files and directories. 
2. Press <F5> to mark each file you want to copy. 
3. Press <Enter>. 
4. Select Copy Marked Files. 


5. Enter the destination path. 
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Purge Deleted Files 
1. Select Purge deleted files. 


2. Press <F1> for help from here. 


Salvage Deleted Files 
1. Select Salvage deleted files. 


2. Press <F1> for help from here. 


Additional Information 








Topic See 

Directory attributes Attributes in Concepts . 
File attributes Attributes in Concepts . 
Hidden attribute Attributes in Concepts . 
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FILTCFG 


Purpose 


Use at the server console to set up and configure filters for IPX, TCP/IP, and 
AppleTalk protocols. 


Syntax 


LOAD FILTCFG 


Using FILTCFG 


Filters help you control what kind of information is sent and received by a 
router by selectively discarding packets of specified types. 


Filters help you to limit specific kinds of traffic to a certain part of your 
network, or to provide security. 


NetWare 4 provides the following filter types: 
@ = Packet forwarding 
@ Service information 
@ Routing information 


The following table shows filtering support for protocols: 
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Table 2-1Filtering Support for Protocols 





Protocol Packet Forwarding Filter Service Information Filter Routing Information Filter 
IPX X X X 
AppleTalk X X 
TCP/IP X X 





Packet Forwarding Filters 


Packet forwarding filters restrict access to services by filtering data packets 
sent by the restricted location to the service location. 


Because these filters don’t restrict Service Advertising Protocol (SAP) packets 
sent by servers, restricted users might see advertisements of services even 
when they cannot access the service. 

Although these filters provide the highest level of security of all the filters, they 


might affect the performance of the router because the filters are applied to 
each data packet the router receives. 


Service Information Filters 


Service information filters restrict service advertisement on a router’s 
internetwork. 


This type of filtering provides low-level security by preventing users from 
finding the network addresses of services. 


It also reduces the network bandwidth consumed by periodic service 
broadcasts. 


Service information filters are of two types: 
@ Service advertisement filters limit the service advertisements sent 
by a router for a specified set of services to a specified set of 


networks. 


@ Service acceptance filters limit the acceptance of service 
advertisements received by the router for a specified set of 
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services at a specified set of networks. (By filtering what a router 
sees, you are restricting the set of services that are advertised by 
the router on any other interface.) 


Routing Information Filters 
Routing information filters restrict the exchange of routing information 
between routers by limiting the routes added to the routing tables of specified 
routers. 
These filters increase network security by limiting the visibility of specified 
networks. They also reduce the bandwidth used by the periodic exchange of 
routing information between routers. 
Routing information filters are of two types: 

@ Route advertisement 


@ Route acceptance 


When you add a routing information filter, an implicit server filter is also added 
for all services residing on the filtered networks. 
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FLAG 


Purpose 
Use at a workstation to 
@ View or modify file and directory attributes to determine which 
operations can be performed with the file or directory 
@ Modify the owner of a file or directory 
@ View or modify the search mode of executable files to determine 
how the program uses search drives when looking for a file 
Syntax 


FLAG path [[+ | -] attribute ...] [/option ...] 
[/? | /VER] 


Parameter Use to 





(no parameter) If you type FLAG with no parameters, the 
attribute status of all the files in the current 
directory appears. 


path Specify the path to the file or directory whose 
attributes or search modes you want to modify. 

+|- Add attributes to a file or directory with the + 
(plus). 


Remove attributes from a file or directory with 
the - (minus). 


If neither + nor - is used, the attributes will be 
assigned to the file/directory as specified. 


If you add and remove attributes in the same 
command, group all + (plus) attributes together 
and all - (minus) attributes together. 
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FLAG 





Using FLAG 





Parameter Use to 





attribute Specify one or more file or directory attributes. 


See “Directory Attributes” and “File Attributes” 


/option Replace option with any available option. See 
“General FLAG Options” 


/? View online help. All other parameters are 
ignored when /? is used. 


/VER View the version number of the utility and the 
list of files it uses to execute. All other 
parameters are ignored when /VER is used. 





For help with tasks, press <F1> in the utility. 


@ Use FLAG options to add or delete directory and file attributes, as 
defined in the preceding parameters table. 


For attributes that can be applied to directories, see “Directory 
Attributes” 


For attributes that can be applied to files, see “File Attributes” 


@ When you add or delete multiple attributes, include a space 
between attribute abbreviations. 


@ You can't remove the Execute Only attribute. You must delete the 
file and then reinstall it. 


@ You can use wildcard characters. 
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General FLAG Options 


Directory Attributes 
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Option 


Use to 





/NAME GROUP name 
/D 


/DO 


/FO 


/OWNER=name 


Change the owner of a file or directory. 
View details about a file or directory. 


View or modify only directories in the specified 
path. 


View or modify only files in the specified path. 


View all files or directories owned by a user. 








/M=mode Modify search modes of executable files. See 
“Search Modes for Executable Files” 

IS Search the subdirectory in the specified path 
and any subdirectories below that level. 

IC Scroll continuously through output. 

Option Use to 

ALL Specify the Di, H, Ic, P, Ri, and Sy attributes as 


Di (Delete Inhibit) 


Dc (Don't Compress) 


Dm (Don't Migrate) 


H (Hidden) 


a group. Primarily used to assign directories 
these specific attributes. 


Prevent the directory from being deleted. 


Prevent the directory from being compressed 
(regardless of what the volume is set to). 


Prevent the directory from being migrated to a 
secondary backup system (regardless of what 
the volume is set to). 


Prevent the directory from being seen with a 
DOS DIR command. 





FLAG 





File Attributes 


Option 





Use to 





Ic (Immediate Compress) 


N (Normal) 


P (Purge) 


Ri (Rename Inhibit) 


Compress the directory as soon as the OS 
can. 


Specify no attributes. 


Purge the directory immediately when the 
directory is deleted. 


Prevent the directory from being renamed. 








Sy (System) Prevent the directory from being seen with a 
DOS DIR command; also to prevent it from 
being copied or deleted. 

Option Use to 

ALL Specify the A, Ci, Di, H, Ic, P, Ri, Ro, Sh, Sy and 


A (Archive needed) 


Dc (Don’t Compress) 


Di (Delete Inhibit) 


Dm (Don’t Migrate) 


Ds (Don’t Suballocate) 


T attributes as a group. Primarily used to 
assign files these specific attributes. 


Indicate that the file has been modified since 
the last backup. 


Prevent a file from being compressed 
(regardless of what the volume or directory is 
set to). 


Prevent a file from being deleted or copied 
over. 


Prevent a file from being migrated to a 
secondary backup system (regardless of what 
the volume or directory is set to). 


Prevent an individual file from being 
suballocated, even if suballocation is enabled 
for the system. Use on files which are enlarged 
or appended to frequently, such as certain 
database files. 
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Option 


Use to 





H (Hidden) 


Ic (Immediate compress) 


N (Normal) 
P (Purge) 
Ri (Rename Inhibit) 


Ro (Read Only) 


Rw (Read Write) 


Sh (Shareable) 


Sy (System) 


T (Transactional) 


X (Execute Only) 


Prevent a filename from being displayed with 
the DOS DIR command. The file can’t be 
copied or deleted. 

Compress a file as soon as the OS can. 
Specify the Rw attribute. 

Purge a file immediately if the file is deleted. 
Prevent a file from being renamed. 

Allow a file to only be read; it can’t be written to 
or deleted (in other words, Ro includes Ri and 
Di). 

Allow a file to be read and written to. 


Allow a file to be used by several users 
simultaneously. 


Prevent a filename from being displayed with 
the DOS DIR command. It can’t be copied or 
deleted. 


Protect a file by using the Transaction Tracking 
System. 


Prevent a file from being copied or copied over. 
This attribute can be given only to .EXE or 
.COM files, and cannot be removed. 





Search Modes for Executable Files 


The syntax is /M=mode . Replace mode with a mode number from the following 


table . 





Mode 


Use to 





0 
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Search for instructions in the NET.CFG file (the 
default mode). 


FLAG 








Mode 


Use to 





Status Flags 


Search the path specified in the file. If there is 
no path, the file searches the default directory, 
and then all search drives. 


Search the path specified in the file. If there is 
no path, the file searches only the default 
directory. 


Search the path specified in the file. If there is 
no path, the file searches the default directory; 
then if the open request is read only, the file 
searches the search drives. 


Reserved; don’t use. 


First search the path specified and then all 
search drives. If there is no path, the file 
searches the default directory and then all 
search drives. 


Reserved; don’t use. 


First search the path specified. If the open 
request is read only, the file searches the 
search drives. If there is no path, the file 
searches the default directory and then all 
search drives. 


Status flags show attribute information for a file or directory. You can’t change 


these flags. 


Status 


Indicates 





Cc (Can’t Compress) 


Co (Compressed) 


M (Migrated) 


The file can’t be compressed because of 
limited space savings. 


The file has been compressed. 


The file has been migrated. 
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Examples 


Additional Information 
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To add Rw and Ic and remove Di and A from all files in the current 
directory, type 


FLAG *.* +R W Ic -Di A 


To view attributes for file STUDENTS in directory 
SYS: \COURSE\ WINTER, type 


FLAG SYS: \COURSE\WINTER\STUDENTS 
To give files in drive G: the Hidden attribute, type 
FLAG G:*.* H /FO 


To set the search mode to 7 for all executable files in the current 
directory, type 


FLAG *.* /M=7 


To set the search mode to 1 and assign all files in the current 
directory the Read Write attribute, type 


FLAG *.* RW /M=1 








Topic See 

Search modes Search modes in Concepts . 
Directory attributes Attributes in Concepts . 

File attributes Attributes in Concepts . 
System directory Attributes in Concepts . 
Hidden attribute Attributes in Concepts . 





FLAG 








Topic See 





File compression Enabling File Compression on a Volume in 
Supervising the Network . 
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FPSM 


Purpose 
FPSM.NLM is a library of C functions that provides floating-point support for 
NLM programs. You don’t need to load FPSM.NLM;; it’s autoloaded by any 


module that needs it. 


See “CLIB” for more information. 
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HALT 


Purpose 
Use at a NetWare 4 SFT III server console to bring down an IOEngine on one 
SFT III server while leaving the other IOEngine running. 

Syntax 
HALT 

Using HALT 


@ HALT is valid only when SFT III servers are mirrored (or before 
SFT III servers are activated). 


@ Execute HALT from the appropriate IOEngine, not from the 
MSEngine. If you execute HALT from the MSEngine, you receive 
an unknown command error. 


@ When the primary IOEngine is brought down using HALT, the 
secondary server automatically takes over as the new primary 
server. When the secondary IOEngine is brought down using 
HALT, the primary server continues running. 


Disks should be mirrored before you halt the primary |OEngine. If the disks 
aren't mirrored when you execute HALT, a warning similar to the following 
appears: 


WARNING!!! Not every disk is remirrored. 
Answering yes may cause some volumes to dismount 
and open files to be lost. 

Are you sure you wish to halt the primary server? 
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HCSS 


Purpose 


Syntax 
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Use at the server console to 


@ View a listing of High Capacity Storage System (HCSS) 
commands and current settings 


@ Change current HCSS settings 


You can also use NetWare Administrator to change HCSS parameter settings. 


HCSS [parameter = setting ] 


You must first install the HCSS software and load HCSS.NLM before using the 
HCSS command to set parameters. See Migrating Data Using the High 
Capacity Storage System in Supervising the Network . 


The HCSS parameters are case sensitive and must be entered exactly as they 
appear in the following table. 


Parameter settings marked with an asterisk are persistent; that is, they are 
saved in memory for the next time HCSS is loaded. The nonpersistent 
parameter settings reset to the default every time HCSS is loaded. 





Parameter Explanation 





(no parameter = setting) Allows you to view a list of HCSS parameters 
and current settings. 


Eject Media Override = Stops media in the jukebox from being ejected. 
setting : 

Supported settings: ON, OFF. 

Default: OFF 





HCSS 





Parameter 





Explanation 





Delete Through = setting 


Migrate Unarchived Files = 
setting 


Migrate Compressed Files 
Only = setting 


Minimum Time In Drive = 


setting 


Maximum Time In Drive = 
setting 


Determines the method of file-deletion 
notification. 


When turned off, expedites the delete request, 
placing requested file deletions in a delete 
queue. 


When turned on, notifies you that the deletion 
was successful only when the deletion is 
complete through to the media. (This method 
provides higher security.) 


Supported settings: ON, OFF. 
Default: OFF 


Specifies whether unarchived files are 
migrated. 


Supported settings: ON, OFF. 
Default: OFF 


Specifies if only compressed files or files that 
can't be compressed are migrated. 


Supported settings: ON, OFF. 
Default: OFF 


Sets the minimum amount of time (in seconds) 
a side of media can remain active before it is 
switched for another side of media. 


This value includes the amount of time it takes 
for the jukebox to move the media into place. 


Supported settings: 0 to 3600. 
Default: 20. 


Sets the maximum amount of time (in seconds) 
that a side of media can remain active before it 
is switched for another side of media. 


Supported settings: 0 to 3600. 
Default: 30. 
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HCSS 
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Parameter 





Explanation 





Request Idle Time = setting 


Migration = setting 


Upper Threshold = setting * 


Lower Threshold = setting * 


Sets the grace period that HCSS waits before 
removing one side of media from the drive to 

load another side of media. The period begins 
when the Minimum Time In Drive time expires. 


Supported settings: Any time period less 
than the difference between the Maximum 
Time in Drive and the Minimum Time In Drive 
settings. 


Default: 2. 


Enables or disables migration. 


Supported settings: ON, OFF 
(ON=migration enabled). 
Default: ON. 


Sets the upper threshold (as a percentage of 
total volume space) that can be reached before 
files begin migrating to magneto-optical disc. 


For example, if this command is set at 70, 
migration begins when the volume has 30% 
free volume space remaining. 


Supported settings: 1 to 100.* 
Default: 80. 


Sets the lower threshold (as a percentage of 
total volume space) at which files stop 
migrating to magneto-optical disc. 


Supported settings: 0 to 99.* 
Default: 50. 


HCSS 





Parameter 





Explanation 





Migrate to Lower Threshold 
Hour = setting” 


Migrate to Lower Threshold 
Minute = setting” 


Remaining Capacity Before 
Warning = setting 


Sets the hour when files begin migrating 
automatically, whether or not the upper 
threshold is reached. 


When this parameter and the Migrate to Lower 
Threshold Minute parameter are both set to 
exactly 0 (the equivalent of 12:00 a.m.), the 
parameter is disabled. Files will not be 
migrated automatically to the lower threshold 
once a day. 


Supported seitings : 0 to 23.* 
Default: 3. 


Sets the minute of the hour when files begin 
migrating automatically, whether or not the 
upper threshold is reached. 


When this parameter and the Migrate to Lower 
Threshold Hour parameter are both set to 
exactly 0 (the equivalent of 12:00 a.m.), the 
parameter is disabled. Files will not be 
migrated automatically to the lower threshold 
once a day. 


Supported settings: 0 to 59.* 
Default: 0. 


Sets (as a percentage of free space remaining) 
when you want to be alerted about the 
volume’s remaining capacity. 


For example, if you set this command to 30, 
you will be alerted that the volume is getting full 
when there is 30% of its free space remaining. 


Supported settings: 10 to 100. 
Default: 20. 
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HCSS 
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Parameter 





Explanation 





Polling Frequency = setting” 


Marking Frequency = 
setting” 


Warning Frequency = 
setting 


Marked Files Limit = setting 


Sets how often (in minutes) you want HCSS to 
check the thresholds you have set. 


If the threshold has been met or exceeded 
during this time interval, migration will begin 
automatically. 


Supported settings: 1 to 34560.* 
Default: 1. 


Sets how often (in minutes) you want to build a 
list of least recently used (LRU) directories that 
are managed by HCSS. 


Supported settings: 1 to 34560.* 
Default: 30. 


Sets how often (in minutes) you want to be 
warned that the volume has exceeded its upper 
capacity threshold. 


Supported settings: 1 to 34560.* 
Default: 2. 


Limits the number of migratable files that are 
scanned for the LRU lists with any setting other 
than zero (0). 


When this is set to zero (0), it means there is no 
limit; every migratable file in the HCSS domain 
is scanned—even if it is already migrated—and 
it goes on the LRU list. 


Supported settings: The total number of files 
flagged for migration, or any number smaller 
than the total. 


Default: 0 (no limit). 


HCSS 





Additional Information 


Topic See 





HCSS Migrating Data Using the High Capacity 
Storage System in Supervising the Network . 


HCSS concepts High Capacity Storage System in Concepts . 
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HELP 


Purpose 


Syntax 


Examples 
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Use at the server console to view the syntax, a brief description, and an 
example of a console command. 


HELP [console command ] [ALL] 








Parameter Use to 
(no parameter) View a list of all console commands. 
console command Specify the name of the console command you 


want to view help for. 


ALL View a short description of each console 
command. 


Press <Enter> after each description to view 
the next description. Press <Esc> to exit. 





@ To view help for SEND, type 
HELP SEND 
@ To view a description of each command, type 


HELP ALL 


INETCFG 





INETCFG 


Purpose 
Use at the server console to set up and customize your internetworking 
configuration for IPX and IP. 
INETCFG simplifies the process of configuring local area networks (LANs) to 
work with network and routing protocols supported by NetWare. 

Syntax 


LOAD INETCFG 


Using INETCFG 


When you load INTECKG, the Internetworking Configuration menu appears, 
as shown in the following figure. You access INETCFG features from this 
menu. 





Internetworking Configuration 


Boards 
Network Interfaces 
WAN Call Directory 


Protocols 
Bindings 
General Node Information 





Menu options are: 
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INETCFG 








Option 


Use to 





Boards 


Network Interfaces 


WAN Call Directory 


Protocols 


Bindings 
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Select and configure boards. To configure a 
board, you choose a driver, assign a name to 
the board, and specify values for the board 
parameters. 


Each driver that is compatible with NetWare 
has a driver description file, sometimes called 
the LDI file. The LDI file defines the parameters 
necessary for the driver to operate with the 
board you select. It also specifies the valid 
range of values for each parameter. 


If a driver has an LDI file, the parameters are 
presented in the Board Configuration window; 
you simply choose a value for each parameter. 


If a driver has no LDI file, you must enter the 
values yourself in the Board Parameters field. 


Applies only to Wide Area Network (WAN) 
configurations for multiple interface WAN 
boards. (NetWare does not support WANs.) 


Applies only to WAN configurations. (NetWare 
does not support WANs.) 


Select and configure network protocols. To 
configure a protocol, you select the protocol, 
such as IPX or IP, and configure the protocol- 
specific parameters that pertain to routing, 
packet forwarding, etc. 


+ Bind a network protocol to an interface. 


+ Configure protocol and interface-specific 
parameters, such as frame type, network 
number (for IPX), local IP address (for IP), 
and zone information (for AppleTalk). 


Delete a bound interface from the 
configuration. 


INETCFG 








Option Use to 





Manage Configuration Specify Simple Network Management Protocol 
(SNMP) information, such as the SNMP device 
name, hardware description, physical location, 
and human contact for the server or router. 


View Configuration 


+ View the INTECFG configuration 
information file and the console messages 
captured during system initialization 


+ Import or export configuration information to 
or from a diskette. 


INETCFG records information in various configuration (.CFG) files located in 
SYS:\ETC. Some of these files are present at system startup; others are created 
by INETCFG, depending on what you configure. Here is a partial list of these 


files: 
@ AURP.CFG 
@ TCPIP.CGF 


@ IPXSPX.CFG 
@ NLSP.CFG 
@ NETINFO.CFG 


INETCFG creates these files strictly for its own use; do not delete them or 
change their contents. 


Additional Information 


Topic See 





AUTOEXEG.NCF file AUTOEXEC.NCF in Concepts . 
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INETCFG 











Topic See 
Capturing console “CONLOG” 
messages 
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INITIALIZE SYSTEM 





INITIALIZE SYSTEM 


Purpose 


Use at the server console to enable the multiprotocol router configuration by 
executing all commands in the system NETINFO.CFG file. 


Syntax 


INITIALIZE SYSTEM 


Using INITIALIZE SYSTEM 


This command is typically executed from the INITSYS.NCF file during server 
startup. 


Executing INITIALIZE SYSTEM on a system that has already been initialized 
can generate errors when the system discovers that the commands in the 
NETINFO.CFG file have already been executed. 


Additional Information 





Topic See 





Server startup “SERVER” 
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INSTALL 


Purpose 
Use at the server console to 
+ Install or upgrade the NetWare operating system on your server 
@ Modify your NetWare server’s configuration 
@ Perform some server maintenance operations 
Syntax 


LOAD [path ] INSTALL 


Parameter Use to 





path Specify the path to INSTALL if you moved it 
from the default directory. 





Additional Information 








Topic See 

Installing NetWare Installation and Upgrade 

Server maintenance Maintaining the NetWare Server in 
Supervising the Network . 
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IPXCON 





IPXCON 


Purpose 


Syntax 


Using IPXCON 


Use at the server console to 


+ 


Monitor and troubleshoot IPX routers and network segments 
throughout your IPX internetwork 


View the status of an IPX router or network segment 
View all paths through which IPX packets can flow 
Locate all active IPX routers on your internetwork 


Monitor remote IPX routers that are running NetWare IPX Router 
software 


LOAD IPXCON [/P] 


Parameter Use to 





/P 


View the Link State Packets (LSPs) received by 
the router, if the remote router is running 
NetWare Link Services Protocol™ (NLSP). 





When you load IPXCON, the top of the screen displays a summary of routing 
statistics for the selected router. (The following figure shows a partial display 
of routing statistics.) The bottom of the screen displays an Available Options 
menu. 
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IPX Console 3.00 


Host Address: RT311-DNL 


Packets Received: 61234 
Packets Sent: 144514 
Packets Forwarded: 0 





The following table explains the fields in the summary display. Because 
IPXCON is a real-time monitor, these fields are always active, and some values 
in the fields change as the router processes IPX packets. 





Field Explanation 
Host Address Name of the router being monitored. 
Packets Received Number of IPX packets received by the 


selected router. 


Packets Sent Number of IPX packets sent by the selected 
router. 
Packets Forwarded Number of IPX packets forwarded by the 


selected router. 


Circuits Number of circuits in use on the router. 


A circuit is a logical attachment to a network 
segment through which a router can reach 
other systems. A circuit can be a local or wide 
area connection. 


Networks Number of networks known to the selected 
router. 
Services Number of services that can be reached from 


the selected router. 


108 Utilities Reference 


IPXCON 





The Available Options menu allows access to additional features of IPXCON. 
These features are described in the following table. 





Option Use to 
SNMP Access Select the server you want to monitor. 
Configuration 


IPX Information 


IPX Router Information 


NLSP Information 


Circuits 


You can monitor the local system, which is the 
default, or a remote system. 


You can monitor the remote system through 
IPX or TCP/IP. 


You can also set the poll interval to specify how 
often the information will be retrieved through 
SNMP. 


View statistics for the selected router’s IPX 
packet routing. 


To display additional packet routing statistics, 
select Detailed IPX Information from the 
bottom of the IPX Information window. 


View general information about the selected 
IPX router. 


View the following NLSP™ information about 
the selected router: 


System information 
Area addresses 
Neighbors 

Routers 

LANs 

LSPs 


To view the Link State Packets (LSPs) received 
by the system, load IPXCON by typing 


LOAD IPXCON /P 


The LSP option is enabled only if the server is 
running NLSP. 


View circuit information. 
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IPXCON 











Option Use to 

Forwarding View the Forwarding table. 

Services View information for the currently reachable 
services. 





+ IPXCON uses Simple Network Management Protocol (SNMP) to 
exchange management information and operational statistics 
with remote IPX routers. 


@ IPXCON operates over both IPX and TCP/IP networks. 
@ To execute IPXCON automatically each time you boot the server, 


add the LOAD IPXCON command after the INITSYS.NCF line in 
your AUTOEXEC.NCF file. 
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IPXPING 


Purpose 


Use at the server console to check connectivity to an IPX server on your 
internetwork. 


Syntax 


LOAD IPXPING 


Using IPXPING 


@ IPXPING sends an IPX ping request packet to an IPX target node 
(server or workstation). When the target node receives the request 
packet, it sends back a reply packet. 


@  Toselect an IPX server or workstation, enter its IPX internal 
network number and node number. 


You can also specify the number of seconds between each request 
packet transmission. 


@ To start sending request packets, press <Esc> . The sending node 
continues to send request packets and collect response time 


statistics until you press <Esc> again to exit IPXPING. 


@ Request and reply packets use the same format; each packet 
contains the standard IPX header. 


+ To add other nodes, press <Insert > and select another server. 
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IPXS 


Purpose 


Syntax 


Using IPXS 
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Provides IPX protocol to NLM programs that require STREAMS™ -based 


IPX. 


LOAD [path ]IPXS [LDFILE = [path ]filename [.ext ]] 


Parameter 


Use to 





path 


LDFILE = [path \\filename 
[.ext] 


Specify the path to IPXS.NLM if you moved it 
from the default directory. 


(Optional) Specify a filename that contains the 
SAP filtering, SAP and RIP timers, and IPX 
configuration parameters. 


Note: If you don't specify a filename, IPXS 
sets the parameters defined in the 
IPXSPX.CFG file. 


If you don't specify a file extension, the default 
is .CFG. 


For example, to load an alternate configuration 
file, type 


LOAD IPXS LDFILE = IPXSPX2.CFG 


The IPXSPX.CFG file is modified from the INETCFG utility when you set 


SPX/IPX parameters. 


@ When you load IPXS, STREAMS is autoloaded. 


IPXS 





Additional Information 


IPXSPX.CFG contains the Service Advertising Protocol (SAP) 
filtering, SAP and Router Information Protocol (RIP) timers, and 
the IPX configuration defaults. 


You can create multiple configuration files in addition to 
IPXSPX.CFG. Use this feature if you frequently alternate between 
two or more IPX/SPX configurations. 


To create multiple configuration files, copy the IPXSPX.CFG file to 
anew filename (IPXSPX2.CFG, for example). Then you can 
change the IPXSPX.CFG file (by using INETCFG) and still 
preserve the original configuration in the IPXSPX2.CFG file. 


To load a configuration file other than the default IPXSPX.CFG 
file, use the LDFILE option. 


For example, if you have a second configuration file called 
IPXSPX2.CFG, you can load that configuration by typing 


LOAD IPXS LDFILE = IPXSPX2 





Topic See 
Filtering RIP and SAP “SET” 
packets using SET 

Filtering RIP and SAP “FILTCFG” 
packets using FILTCFG 

Setting IPX parameters “SET” 
using SET 

Setting IPX parameters “INETCFG” 


using INETCFG 


STREAMS-based protocols STREAMS in Concepts . 
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KEYB 


Purpose 


Use at the server console to change the console keyboard type to the language 
of your keyboard. 


The language you specify with KEYB must match the language of your 
keyboard, not the server language. 


Changing the keyboard type causes some keys to represent different 
characters. Therefore, do not use this command unless you have the 
appropriate keyboard for the language you are specifying and you are familiar 
with the keyboard’s use. 


Syntax 


LOAD [path ]KEYB [keyboard_type ] 





Parameter Use to 
(no parameter) View a list of available keyboard types. 
path Specify the path to KEYB.NLM if you moved it 


from the default directory. 
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KEYB 








Parameter Use to 





keyboard_type Specify one of the following keyboard types: 


Belgium 
Canadian French 
Denmark 
France 
Germany 

Italy 

Latin America 
Netherlands 
Norway 
Portugal 
Russia 

Spain 

Sweden 

Swiss French 
Swiss German 
United Kingdom 
United States 


Using KEYB 


To change the keyboard type, unload KEYB and then reload it, specifying the 
new keyboard type parameter. 


Additional Information 





Topic See 
Changing the server Changing the Server Keyboard Type in 
keyboard type Supervising the Network . 
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LANGUAGE 


Purpose 


Syntax 


Examples 
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Use at the server console to set the language for subsequently loaded modules. 


LANGUAGE does not change the language of the operating system or of 
currently loaded modules. 


The LANGUAGE command gives the modules access to directories 
containing message files in the specified language. This directory structure is 


under SYS:SYSTEM as follows: 


SYS:SYSTEM\NLS\Language_number 


LANGUAGE [language_name | number ] [LIST | REN number 
new_name ] 





Parameter Use to 





(no parameter) View the current language setting for modules. 
language_name | number Specify a language by its name or number. 


LIST Display a list of language names and numbers. 
(Not all languages in the list are supported.) 


REN number new_name Rename a language specified by a language 
number. The syntax is: 


LANGUAGE REN number new_name 





+ — To set a module to use the German message files, type 


LANGUAGE GERMAN 


LANGUAGE 





or 
LANGUAGE 7 

@ To change the name of Spanish to Espanol, type 
LANGUAGE REN 14 ESPANOL 

@ To display a list of language names and numbers, type 


LANGUAGE LIST 


Additional Information 


Topic See 





Specifying a language for Specifying a Language for an NLM in 
modules Supervising the Network . 
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LIST DEVICES 


Purpose 
Use at the server console to display a list of the devices on the server and to 
register new devices with the server. 
A device can be a disk drive, magneto-optical disc drive, CD-ROM, or any 
other physical device. 

Syntax 


LIST DEVICES 


Using LIST DEVICES 


The command output is returned by the device drivers. The information for 
each device includes the device number and name, as well as additional 
information that varies by device and by manufacturer. 


Following is an example of a device listing: 


1. Device #0 Conner Peripherals 121MB - CF3 
2. Device #1 Compaq IDA Slot 1 Dsk 1 NFT 
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LOAD 


Purpose 


Syntax 


Using LOAD 


Use LOAD to link loadable modules to the operating system. Loadable 
modules include disk drivers, LAN drivers, NLM programs, and name space 
modules. 


Use the LOAD command at the server console to load server NLM programs 
or at a workstation running the NetWare Client 32™ software to load Client 
32 NLM programs. 





LOAD [path ]Jloadable_module_name [parameter ...] 
Parameter Use to 
path Specify the path to the loadable module if you 


moved it from the default directory. 


loadable_module_name Specify the name of the loadable module. To 
determine the name, see the documentation 
for the loadable module. 


parameters Include parameters specific to the module you 
are loading. See the documentation for the 
loadable module. 


@ Whena module is loaded, it links itself to the system and allocates 
a portion of the computer’s memory for its use, thus using system 
resources. When modules are unloaded, allocated resources are 
returned to the system. 


Some modules, such as LAN drivers and disk drivers, need to be 
loaded every time the server is booted. To load modules 
automatically when the server boots, include LOAD commands in 
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Examples 
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the AUTOEXEC.NCF or STARTUP.NCF file. (See Creating or 
Editing a Server Batch (.NCF) File in Supervising the Network) 


Other modules, such as INSTALL, can be loaded, used, and then 
unloaded. Refer to the documentation for the specific module. 


LAN drivers can also be loaded with INSTALL and with 
INETCKG. (See Loading and Binding LAN Drivers in Supervising 
the Network and “INETCFG” ) 

When you install SYSTEM and PUBLIC files on the server, any 
.NLM and .LAN modules are copied to SYS:SYSTEM. The .DSK 
and .NAM modules are copied to the boot directory of the server. 
If you receive an error message indicating that a third-party server 
NLM is not allowing low-priority processes to run, load the NLM 
on the server using this option: (CLIB_OPT)/Y. This option 
instructs the system to run low-priority processes as well as high- 


priority ones. The command syntax is: 


LOAD third-party NLM (CLIB_OPT) /Y 


The parentheses are required. 


To load a DCB driver, type 

LOAD A:DCB PORT=320 

To load an ISADISK driver, type 

LOAD A: ISADISK 

To load the NE3200™ driver (without parameters), type 
LOAD NE3200 

To load the TRXNET driver (with parameters), type 


LOAD TRXNET INT=3 PORT=2E0 MEM=C0000 


LOAD 





@ To load the Macintosh name space module, type 
LOAD MAC 
@ To load the INSTALL module, type 


LOAD INSTALL 


Additional Information 





Topic See 

Loading disk drivers Load the Device Drivers in Installation and 
Upgrade 

Loading LAN drivers Loading and Binding LAN Drivers in 
Supervising the Network 

Loading name space Setting Up a Volume to Store Non-DOS Files 

modules in Supervising the Network 

Loading modules Loading a NetWare Loadable Module in 
Supervising the Network 
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LOGIN 


Purpose 


Syntax 


Using LOGIN 
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Use at a workstation to access the network by logging in to a server and running 


a login script. 


LOGIN [server name/ 
? | /VER] 


Parameter 


| tree/ ][user ] [/option ...][/ 


Use to 





(no parameter) 
server name / 
tree / 

user 


/option 


/? 


/VER 


Request a login prompt. 

Specify the server you want to log in to. 
Specify the tree you want to log in to. 

Specify the username you want to log in with. 


Replace option with any available option. See 
“LOGIN Options” 


View online help. All other parameters are 
ignored when /? is used. 


View the version number of the utility and the 
list of files it uses to execute. All other 
parameters are ignored when /VER is used. 


@ Using LOGIN implies use of the LOGOUT command. That is, 
using LOGIN to access an additional server logs you out of all 


other servers. 


To remain logged in to other servers, use the no script (/NS) 


option. 


LOGIN 





LOGIN Options 


Using the /NS option is similar to using the ATTACH command in NetWare 3. 


@ To use another object’s login script, you need the Read property 
right to the Login Script property of that object. This login script 
replaces the profile script (if one is specified). 


@ To set your context before you log in, either use the CX command 
or set your context in the NET.CFG file using the following 


statement: 


name context 


Option 


complete name 


Use to 





/NS 


/NB 


/S path | object name 


/B 


/PR=profile object name 


/NOSWAP 


SWAP=path 


/TREE 


Prevent a login script from running and prevent 
you from being logged out of other servers you 
are logged in to. 


Prevent the Welcome to NetWare banner from 
being displayed during the login process. 


Specify a login script file. 
Replace path with the path to the script. 


Replace object name with the object whose 
script you want to run. 


Specify a bindery login. 


Specify the Profile object script you want to 
run. 


Prevent LOGIN from swapping to extended or 
expanded memory, or to disk. 


Tells login to swap to this path when external 
commands are executed. DOS only. 


Specify that you want to log in to a tree. 
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Examples 


@ To log into server MOUSE as user RICKY without logging out of 
other servers you are logged in to, type 


LOGIN MOUSE/RICKY /NS 
@ To log in to tree TERMINAL as user RICK, type 
LOGIN TERMINAL/RICK /TREE 


+ To login to the Directory tree as user SAM (if current context is set 
to SAM’s container), type 


LOGIN SAM 


+ Tologinas user SAM and specify a Profile object to use as a login 
script, type 


LOGIN SAM /PR=WPGROUP . NOVELL 


Additional Information 





Topic See 





Login scripts Login scripts in Concepts and About Login 
Scripts in Supervising the Network . 


Using NOSWAP with NOSWAP in Supervising the Network . 
LOGIN.EXE 
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LOGOUT 





LOGOUT 





Purpose 
Use at a workstation to exit the network or to log out of servers. 
Syntax 
LOGOUT [server name | /T][/? | /VER] 
Parameter Use to 
(no parameter) Exit the network by logging out of all servers 


and Directory Services. 

server name Specify the server you want to log out of if you 
want to log out of one server but remain logged 
in to other servers or to the Directory tree. 

/option Replace option with any available option. 

/T Log out of Directory Services and all servers in 
the Directory tree, but not out of bindery 
servers (NetWare 3 servers). 


/? View online help. All other parameters are 
ignored when /? is used. 


/VER View the version number of the utility and the 
list of files it uses to execute. All other 
parameters are ignored when /VER is used. 


Using LOGOUT 


You can use wildcard characters in the server name parameter. 


Examples 


@ To log out of all servers, type 
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LOGOUT 


@ To log out of server EXODUS while remaining logged in to other 
servers, type 


LOGOUT EXODUS 
@ To log out of all servers that begin with TEST, type 


LOGOUT TEST* 
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MAGAZINE 


Purpose 


Syntax 


Use at the server console in response to the screen prompts Insert Magazine and 
Remove Magazine. The screen prompts refer to media magazines (hardware 
devices that hold several pieces of media). 


MAGAZINE [parameter ] 





Parameter Use to 





Inserted Confirm that the media magazine was inserted 
in response to the Insert Magazine prompt. 


Not Inserted Confirm that the media magazine was not 
inserted in response to the Insert Magazine 
prompt. 


Not Removed Confirm that the media magazine was not 
removed in response to the Remove Magazine 
prompt. 


Removed Confirm that the media magazine was 
removed in response to the Remove Magazine 
prompt. 
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MAP 


Purpose 
Use at a workstation to 
@ View drive mappings 
@ Create or change network or search drive mappings 
@ Map adrive toa fake root directory (for applications that must use 
a root directory) 
Syntax 


MAP [P | NP] [option ...] drive:= [drive : | path ] 
[/? | /VER] 





Parameter Use to 

(no parameter) View drive mappings. 

P Map to a physical volume. Must be listed first or 
second. 

NP Overwrite local or search drives without being 


prompted. Must be listed first or second. 


option Replace option with any available option. See 
“MAP Options” 

drive : Specify the drive you want to change. 

path Specify the path you want to map a drive to. To 


map to a physical volume on a server that is not 
your default server, specify the entire path 
(including server, volume, and directory name). 
For example, 
MACBETH/SYS:ACCOUNTS\PAY 
(server/volume:directory\subdirectory) 
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MAP 








Parameter 


Use to 





/? 


/VER 


View online help. All other parameters are 
ignored when /? is used. 


View the version number of the utility and the 
files it uses to execute. All other parameters are 
ignored when /VER is used. 





@ Ifyou don’t include drive mappings in your login script, they will 
have to be manually recreated each time the user logs in. (See 
Creating Login Scripts in Supervising the Network .) 


@ You can have up to 26 mappings, including local drives. 


@ Search drive mappings begin with the letter Z and continue 
backward through the alphabet. 


@ To map a search drive, use S and a number. (See “MAP Options” ) 


@ Ifyou don't want to overwrite existing search drives, use the INS 


+ To map to the next available search drive, use S16:= 





Use to 





Using MAP 
option. 
MAP Options 
Option 
P 
Np 
C 


Map to a physical volume. Must be listed first or 
second. 


Overwrite local or search drives without being 
prompted. Must be listed first or second. 


Change a regular drive to a search drive, or a 
search drive to a regular drive. 
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Examples 
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Option Use to 
DEL Delete a drive mapping. 
INS Insert a search drive mapping without 
replacing an existing mapping. 
N Map the next available drive to the specified 
path. 
ROOT Map a drive to a fake root directory for 
applications that require rights in a root 
directory. 
WwW Do not change master environment. 
@ To view mappings, type 
MAP 

@ To map drive G: to SYS:\HOME\JAN on the current server, type 
MAP G:=SYS:\HOME\JAN 

@ To extend the mapping for drive G: above to SYS:\ HOME\JAN\ 
PROJECTS, type 
MAP G:=PROJECTS 

@ To map search drive 4 to PRUFROCK (server) SYS (volume) APP 
(directory), type 
MAP S4:=PRUFROCK/SYS:APP 

@ To change Y: from a regular NetWare drive to a search drive, type 
MAP C Y: 

@ To delete the mapping for drive G:, type 


MAP 





MAP DEL G: 


@ To map drive F: to the DOSGAMES volume of the GAMES 
directory as a fake root, type 


MAP ROOT F:=GAMES\DOSGAMES : 


@ To map the last possible search drive to IZARD (server) SYS 
(volume) PUBLIC (directory), type 


MAP S16:=IZARD/SYS: PUBLIC 


@ To map the next available drive to Z:\PUBLIC\DOS\APP from 
Z:\PUBLIC, type 


MAP N DOS\APP 


@ To map the next available drive to BRUTUS/SYS:ACCT\ 
OLD, type 


MAP N BRUTUS/SYS:ACCT\OLD 


@ To insert COUNT (server) SYS (volume) PUBLIC (directory) as a 
new search drive, type 


MAP INS S4:=COUNT/SYS:PUBLIC 


+ To map to PUBLIC\RPTS under Volume object 
SYS.ACCOUNTING.ACME.US from the root, type 


MAP H:=.SYS.ACCOUNTING.ACME.US:PUBLIC\RPTS 


Additional Information 





Topic See 
Directory Map objects Directory Map object in Concepts . 
Fake roots Fake root in Concepts . 
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Topic 





See 





Login scripts 


Search drive mappings 


Login scripts in Concepts . 


About Login Scripts in Supervising the 
Network . 


Drive mapping and Search drive in Concepts . 


MATHLIB 





MATHLIB 


Purpose 


The MATHLIB module was used originally to provide mathematical functions 
to CLIB if your server had a math coprocessor. 


However, MATHLIB functionality is now incorporated into the CLIB module, 
which is automatically loaded by any other module that needs it. Therefore, 


you don’t need to load MATHLIB. 


MATHLIB now exists as a stub that can be called by older NLM programs. 


Additional Information 





Topic See 





CLIB module “CLIB” 





Chapter 2: Utilities 133 


MATHLIBC 





MATHLIBC 


Purpose 


The MATHLIBC module was used originally to provide mathematical 
functions to CLIB if your server didnt have a math coprocessor. 


However, MATHLIBC functionality is now incorporated into the CLIB 
module, which is automatically loaded by any other module that needs it. 


Therefore, you dont need to load MATHLIBC. 


MATHLIBC now exists as a stub that can be called by older NLM programs. 


Additional Information 





Topic See 





MATHLIB “MATHLIB” 
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MEDIA 


Purpose 


Use at the server console in response to the screen prompts Insert Media and 
Remove Media. 


Syntax 


MEDIA [parameter ] 


Parameter Use to 





Inserted Confirm that the specified media was inserted 
in response to the Insert Media prompt. 


Not Inserted Confirm that the specified media was not 
inserted in response to the Insert Media 
prompt. 


Not Removed Confirm that the specified media was not 
removed in response to the Remove Media 
prompt. 


Removed Confirm that the specified media was removed 
in response to the Remove Media prompt. 
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MEMORY 


Purpose 


Use at the server console to display the total amount of installed memory that 
the operating system can address. 


Syntax 


MEMORY 


About Memory Addressing 


+ OnEISA bus computers, NetWare 3.1 and later versions address 
memory above 16 MB. 


@ Onmicrochannel and ISA (AT) bus computers, NetWare (all 
versions) can address memory only up to 16 MB. 


@ — On PCI bus computers, NetWare 4 can address up to 64 MB. 


Additional Information 








Topic See 

Enabling the operating “REGISTER MEMORY” 
system to address memory 

above 16 MB 
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MEMORY MAP 


Purpose 


Use at the server console to display the amount of memory (in bytes) allocated 
to DOS and to the server. 


Syntax 


MEMORY MAP 


Using MEMORY MAP 


In NetWare 4 SFT II, MEMORY MAP displays the memory allocated to 
DOS, the IOEngine, and the MSEngine (the unclaimed memory if the 
MSEngine is not loaded). SFT II allocates the unclaimed memory to the 
MSEngine during synchronization. 


@ MEMORY MAP can help you determine if your SFT III servers are 
addressing equal amounts of memory. If the two servers have 
unequal amounts of RAM installed, you may experience 
synchronization problems. 


@ In SFTI, you must execute MEMORY MAP from the IOEngine. 
If you execute MEMORY MAP while in the MSEngine, the system 
recognizes MEMORY MAP as the MEMORY command. 


In native NetWare, MEMORY MAP displays the memory allocated to DOS 
and to the server’s memory. 
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MIRROR STATUS 





Purpose 

Use at the server console to 

@ View the status of mirrored disk partitions 

@ View the percentage of mirrored data on each partition 
Syntax 


MIRROR STATUS [logical_partition_number ] 








Parameter Use to 
(no parameter) View a list of all logical disk partitions. 
logical_partition_number Display the partition’s physical device 


number(s), as well as its mirrored status. 


Using MIRROR STATUS 


If you specify a logical partition number, MIRROR STATUS displays the 
partition’s physical device number as well as its mirrored status. The possible 
status messages are explained in the following table. 





Status Explanation 





Being remirrored Remirroring is in progress, and the percent 
completed is displayed. 


Fully synchronized The mirrored partitions have the same data. 
Remirroring is complete. 


For SFT Ill systems, this message refers to 
unmirrored drives synchronized with 
themselves. 
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Status Explanation 





Not mirrored Disk mirroring was not set up for this partition. 
It has no mirrored partner. 


Orphaned state An error occurred during remirroring with the 
result that the partition was not remirrored. 


Note: You can restore the orphaned partition 
to its mirrored partner with INSTALL. 


Out of synchronization One partition does not have the same data as 
its partner, and it is not being remirrored. 


In SFT III systems, MIRROR STATUS must be executed from the MSEngine. 
If you execute MIRROR STATUS from either IOEngine, you receive an 
Unknown command error message. 


Additional Information 


Topic See 





Mirroring disks Mirroring and Duplexing a Hard Disk in 
Supervising the Network . 
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MODULES 


Purpose 
Use at the server console or a workstation running the Novell Client Software 
to display a list of currently loaded modules. For each module, the command 
displays the following information: 
@ The module short name 
@ A descriptive string or long name for each module 
@ The version number if the module is a disk driver, LAN driver, or 

NLM 
Syntax 


MODULES [string ] 





Parameter Use to 
(no parameter) View a list of all loaded modules. 
string Display a list of all modules with names 


matching the string. The string can contain an 
asterisk (*) as the last character. In this case, 

the system displays a list of all modules whose 
names begin with the string. 


For example, MODULES D* displays a list of all 
modules beginning with the letter D. 





Additional Information 





Topic See 





Loadable modules NetWare Loadable Module in Concepts . 
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MODULES 








Topic See 





Loading modules Loading a NetWare Loadable Module in 
Supervising the Network . 


“LOAD” 
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MONITOR 








Purpose 
Use at the server console to 
@ View server activity 
@ Lock the console 
@ Assess server RAM and CPU utilization 
@ Set server parameters 
Syntax 
LOAD [path ]MONITOR [option ] 
Parameter Use to 
path Specify the path leading to MONITOR if you 
moved it from the default directory. 
option Specify a MONITOR option. 
MONITOR Options 
Option Use to 
L Lock the console upon loading MONITOR. 


To lock the console upon booting, place this 
option in the AUTOEXEC.NCF file. 


Note: If you use this option, use the supervisor 
password to unlock the console. 
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Option 


Use to 





Tnn 


Using MONITOR 


Load MONITOR without the screen saver. 


By default, NetWare has a snake-like screen 
saver that moves randomly on the server 
screen. 


If you load MONITOR without the N option, a 
snake appears on the screen after 1 minute of 
inactivity if the console is locked (after 10 
minutes if it is not locked). 


As network use increases, the snake moves 
faster and the tail gets longer. To retrieve the 
MONITOR display, press any key. 


Specify the number of seconds of keyboard 
inactivity before the screen saver is activated. 
Replace nn with a number in seconds 


Activate the screen saver only if the MONITOR 
window is displayed on the screen. 


Without the M option, the screen saver is 
activated no matter what window is displayed. 


The main MONITOR screen displays server statistics and a menu that allows 
you to access additional information. The following figure shows a typical 


main screen display. 
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Figure 2-5 
The MONITOR Main Screen 


General Information 


Server up time: 0:00:14:19 
Active processors: 1 
Utilization: 107 
Original cache buffers: 3,495 
Total cache buffers: 2,280 
Dirty cache buffers: 1 


Available Options 


Connection information 

Disk information 

LAN/WAN information 

System module information 

Lock file server console 

File open/lock activity 
¥iCache utilization 





See the following tables for explanations of the information on the MONITOR 
screen: 


@ Table 2-2 , Statistics in the MONITOR ‘General Information’ 
Display 


@ = Table 2-3, MONITOR ‘Available Options’ Menu 


For information about all MONITOR statistics and menu options, press <F1> for 
online help. 
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Table 2-2Statistics in the MONITOR General Information Display 


Statistic 


Explanation 





Operating system 
version and date 


Server server name on 
network tree name 


Server Up Time 
Active Processors 


Utilization 


Original Cache Buffers 


Total Cache Buffers 


Dirty Cache Buffers 
Current Disk Requests 
Packet Receive Buffers 


Directory Cache Buffers 


The version and release date of the system (upper left corner of the screen). 


The name of the server and the Novell® Directory Services tree name. 


The length of time the server has been running since it was last booted. 
The number of enabled processors. 


On a uniprocessor server, reflects CPU utilization. This number is relative to 
the amount of time the kernel spends in the idle loop process. 


On a multiprocessor server, this value is the average utilization of all active 
processors. For utilization information about individual processors, select 
Multiprocessor Information from the Available Options menu. 


This value is reset when a change in system configuration occurs such as an 
NLM being loaded or unloaded, or a volume being mounted or dismounted. 


Note: To measure CPU utilization exactly, see the histogram displayed when 
you select either Scheduling Information or Processor Utilization from the 
Available Options menu. 

The number of cache buffers available when the server is booted. The figure 
represents the number of blocks installed as cache memory in your server. 
Default block size: 4 KB. 


The number of blocks available for file caching. This number decreases as 
modules are loaded. 


The number of file blocks in memory waiting to be written to disk. 
The number of disk requests (in a queue) the server is waiting to service. 
The number of buffers available to handle station requests. Default: 10. 


The number of buffers allocated to handle directory caching. 
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Statistic 


Explanation 





Maximum Service 
Processes 


Current Service 
Processes 


Maximum Licensed 
Connections 


Current Licensed 
Connections 


Open Files 
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Indicates the number of task handlers the system allocates to service client 
requests. 


Once memory is allocated for service processes, it remains allocated even 
when no longer required. Each service process requires 4 KB of RAM. 


You can set this parameter using SET. For more information, press <F1> for 
online help. 


The number of service processes currently allocated. If this number 
corresponds to the Maximum Service Processes value, performance will be 
adversely affected. You should allocate more service processes. Use the SET 
utility to set the Maximum Service Processes parameter. 


The maximum number of licensed server connections possible. This number 
corresponds with the number-of-users version of NetWare you purchased. 


The number of active licensed connections. These connections count toward 
the limit on your NetWare license. 


For example, if you have a NetWare license for 50 users and there are 
currently 45 licensed connections, you have 5 unused connections. 


To view the current licensed connections, choose the Connection Information 
option from the Available Options menu. 


The number of files being accessed by the server and by workstations. 


MONITOR 





Table 2-3MONITOR Available Options Menu 


Menu Option Use to 





Connection Information List active connections. 
List licensed and unlicensed connections. 
List record locks for a user. 
Clear a connection. 
List open files. 
List record lock status of open files. 
Send a message to a workstation connection. 


Note: Press <F3> to sort the items in the connection list. 


Disk Information List system hard disks. 
List volume segments per hard disk. 
Change the Read After Write Verify status of the hard disk. 
Flash the hard disk light. 
Change the drive light status. 
Activate/deactivate a hard disk. 
Mount/dismount a removable media device. 
Lock/unlock a removable media device. 


LAN/WAN Information List LAN driver configuration and statistics. 
View the LAN driver version and the protocols bound to it. 
View node and network address. 


Note: For information on each LAN driver statistic, see “LAN Driver Statistics’ 
on page 479 


Note: MONITOR does not provide LAN driver statistics for SFT Ill servers. 


System Module List modules loaded on the system by name, size, and version. 
Information List size of module code and data image. 

List resources allocated by the module (resource tags). 

View resource tag memory usage. 


Lock File Server Console Lock or unlock the server console keyboard. 


Once the keyboard is locked, you cannot change screens until you unlock the 
keyboard, using either the password that you used to lock the console or the 
ADMIN password. 


File Open/Lock Activity Check a file's lock activity and status. 
View which stations have open files. 
View mounted volumes and directories on each volume. 
View files in a directory. 
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Menu Option 


Use to 





Cache Utilization 


Processor Utilization 


Resource Utilization 
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View disk cache block request statistics including: total cache block requests, 
the number of times a block request had to wait because there were no 
available cache blocks, long and short term cache hits and dirty cache hits. 


Use the Long Term Cache Hits information (the percentage of time the 
operating system retrieves the data it needs directly from cache) to assess 
server RAM. 


Note: For more information on these statistics, press <F1> for help while in 
this screen. 


Select an active process or multiple processes and available interrupts to 
sample for a histogram. 


View a histogram for the selected processes. 


The histogram displays CPU usage and the number of times the CPU has 
serviced the process during the sample period. 


To measure CPU utilization, view the Idle Loop process in this screen and find 
the LOAD percentage associated with this process. 


To calculate exact CPU utilization, subtract this percentage from 100%. 


Note: Ona multiprocessor server, this information is for processor 0. For 
information about other processors, select the Multiprocessor Information 
menu option. 


View memory usage statistics for the cache buffer pool, allocated memory in 
movable and non-movable memory pools, and code and data memory. 


View tracked resources (resource tags) allocated by the operating system and 
NLM programs. 


When you select Resource Utilization, the upper screen displays a Server 
Memory Statistics window. 


MONITOR 








Menu Option Use to 





Memory Utilization View allocated memory information for the entire system or for one selected 
system module. 


View memory statistics such as the percent of allocated memory in use, 
memory blocks and bytes in use, free blocks. 


Perform garbage collection for the system or for one module. Press <F3> in 
the System Modules window to perform garbage collection for the whole 
system. Or select one module from the System Modules window and then 
press <F3> to perform garbage collection on that module. 


Note: For more information, press <F1> for help while in the System Modules 
window. 


Scheduling Information View and change the priority of a process by delaying CPU execution of a 
process. 


View the number of times the process ran during the sample period and the 
CPU time spent executing code for that process. 


Server Parameters Set values for server parameters. This menu item functions the same way as 
the SERVMAN utility. 


Exit Exit MONITOR. 





Additional Information 





Topic See 





Assessing server RAM Assessing Server RAM in 
Supervising the Network . 


Checking a server’s processor Checking a Server's Processor 

utilization Utilization in Supervising the 
Network . 

Checking for disk errors Checking For Disk Errors in 


Supervising the Network . 


Listing LAN drivers and statistics Viewing LAN Driver Statistics in 
Supervising the Network . 
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Topic 





See 





LAN driver statistics 


Clearing workstation connections 


Sending a message to a workstation 
connection 


Increasing communications buffers 


Prioritizing server processes 


Setting server parameters 


Appendix A, “LAN Driver Statistics” 


Clearing a Workstation Connection in 
Supervising the Network . 


“CLEAR STATION” 


Sending a Message Using MONITOR 
in Supervising the Network 


Increasing the Maximum Number of 
Packet Receive Buffers in 
Supervising the Network . 


“SCHDELAY” 


Prioritizing Server Processes in 
Supervising the Network . 


“SERVMAN” or “SET” 





MOUNT 





MOUNT 


Purpose 


Syntax 


Using MOUNT 


Use at the server console to make a volume available to users. 


CD-ROM volumes must be mounted using the CD command. For more 
information, see “CD” on page 27 








MOUNT volume_name ALL 
Parameter Use to 
volume_name Specify the name of the volume you want to 
mount. 
ALL Mount all volumes not mounted. 





@ Ifyou set up the AUTOEXEC.NCF file to mount all volumes 
automatically each time the server comes up, then you would use 
the MOUNT command only if you have dismounted a volume 
and want to remount it. 


@ After you replace a removable drive, use this command to mount 
all volumes residing on the removable drive. 


@ — You can mount and dismount volumes while the server is 
running. 


@ — You can also use INSTALL to mount a volume. Select Volume 
Options from the Installation Options menu. 
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Examples 
@ To mount volume STATISTICS, type 
MOUNT STATISTICS 
@ To mount all unmounted volumes at once, type 


MOUNT ALL 
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MPDRIVER 


Purpose 
Use at the server console to enable processors in a multiprocessor server 
running NetWare Symmetric MultiProcessing (SMP) software. 
Before you can use MPDRIVER, you must first install NetWare SMP. 
Syntax 


LOAD MPDRIVER {processor_number | ALL} 





Parameter Use to 

processor_number Specify the number of a processor to 
enable. 

ALL Enable all licensed processors. 


Using MPDRIVER 


@ Once NetWare SMP has been installed, you can use MPDRIVER to 
enable and disable individual processors dynamically. You must 
first unload all the processors (except processor 0) by executing 
the following command at the server console prompt: 


UNLOAD MPDRIVER 


You can then reenable one or more individual processors by 
executing the LOAD MPDRIVER command with a processor 
number as a parameter. 


@ You cannot enable or disable processor 0. 
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Purpose 
Use at the server console to load the IOEngine on each NetWare 4 SFT III 
server. 
Syntax 
MSERVER [parameter ...] 
Parameter Use to 
-ns Prevent execution of the IOSTART.NCF file. 


This parameter is useful if you are changing 
commands in your IOSTART.NCF file. 


-na Prevent execution of the IOAUTO.NCF file. 
This parameter is useful if you are changing 
the modules loaded by your IOAUTO.NCF file. 


Both (-ns -na) Load the |OEngine without executing the 
IOSTART.NCF and IOAUTO.NCF files. 


Using MSERVER 
@ MSERVER executes the IOSTART.NCF and IOAUTO.NCF files. 
@ Execute MSERVER from the DOS prompt of each SFT III server. 
@ Type MSERVER parameters in lowercase. 


@ Ifthe IOSTART.NCF file doesn’t exist, MSERVER prompts you for 
an IOEngine name and an IPX internal network number. 
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NAME 


Purpose 


Use at the server console to display the server name. 


Syntax 


NAME 
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NCOPY 


Purpose 


Use at a workstation to copy files or directories from one location to another. 


Syntax 


NCOPY [source_path ] filename target_path [filename 


] [/option... 


Parameter 


[/? | /VER] 


Use to 





source_path 


filename 


target_path 


[filename ] 


/option 


/? 


/VER 





Using NCOPY 


Specify the path leading to the source file. (You 
can use a drive letter.) Include this if the file is 
not in your current directory. 


Specify the file you want to copy. 


Specify the path for the directory you are 
copying the file to. (You can use a drive letter.) 


Specify a new name for the file (if you want to 
rename the file.) 


Replace option with any available option. See 
“NCOPY Options” 


View online help. All other parameters are 
ignored when /? is used. 


View the version number of the utility and the 
files it uses to execute. All other parameters are 
ignored when /VER is used. 


@ You can use drive letters instead of directory paths to specify 
source and target paths. 
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NCOPY Options 


@  Youcan use wildcard characters. 


Earlier versions of NCOPY are not supported by NetWare 4. If you have any 
servers in your Directory tree that are running earlier versions of the NetWare 
operating system (and thus have older versions of NCOPY), you should copy 
the 4 version of NCOPY to them. 





Option Use to 

(Option Name) 

A Copy only those files that have the 

(Archive Bit Only) archive bit set. The attribute of the 
source file is not changed. 

M Copy files that have the archive bit set. 

(Archive Bit Set) Turns off the archive bit of the source file. 
This option allows NCOPY to be used in 
backup. 

C Copy files without preserving extended 

(Copy) attributes and name space information. 

F Force the operating system to copy 

(Force Sparse Files) sparse files. 


| Notify you when extended attributes or 
nform name space information cannot be 
Inf inf ti t b 
copied because the target volume 
doesn't support those features. 


R Keep compressed files compressed. 
(Retain Compression) 


/R/U Keep compressed files compressed 
(Retain Unsupported even when they are copied to media that 
Compression) doesn't support compression. 

S Copy subdirectories as well as files. 


(Subdirectories) 
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Examples 


158 Utilities Reference 





Option Use to 
(Option Name) 





/S/E Copy empty subdirectories as well as 
(Subdirectories Empty) files. 

V Verify that the original and the new files 
(Verify) are identical. For local DOS drives only. 

@ Tocopy an empty subdirectory to the subdirectory above your 


current drive, type 

NCOPY WORK .. /S /E 

To copy files that start with S and have a .TXT extension and have 
the archive bit set to a subdirectory named TEST below your 
current directory, type 


NCOPY S*.TXT TEST /A 


To copy all files from C:\DOS to D:\TEMP when you are not in 
either directory, type 


NCOPY C:\DOS *.* D:\TEMP 

To copy all files with the .RPT extension to 
SERVER1_SYS:PUBLIC\SHARE on another volume and be 
notified if extended attributes or name space information cannot 
be copied, type 


NCOPY *.RPT SERVER1_SYS:PUBLIC\SHARE /I 


To copy all files with the .DOC extension to directory ACCT and 
verify that the original and the new files are identical, type 


NCOPY *.DOC ACCT /V 


To copy a file named MARCH.RPT to drive G:, type 


NCOPY 





NCOPY MARCH.RPT G: 


@ To copy all files and subdirectories in the current directory toa 
subdirectory, type 


NCOPY *.* .. \TEMP /S 

@ To copy all files with the .RPT extension to PUBLIC\RPTS under 
Volume object ACCT_SYS.ACCOUNTING. ACME.US from the 
root, type 


NCOPY *.RPT .ACCT_SYS .ACCOUNTING 
. ACME . US : PUBLIC\RPTS 


Additional Information 





Topic See 

Sparse files Sparse file in Concepts . 

Name space Name space support in Concepts . 
Archive bit Attributes in Concepts . 
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NCUPDATE 


Purpose 


Syntax 


Using NCUPDATE 


160 Utilities Reference 


Use at a workstation to automatically update users’ NET.CFG files with a new 
name context after a container has been moved or renamed. 


NCUPDATE [/? | /VER] [/NP] 


Parameter Use to 





/? 


View online help. All other parameters are 
ignored when /? is used. 


/VER View the version number of the utility and the 


/NP 


files it uses to execute. All other parameters are 
ignored when /VER is used. 


Avoid getting the prompt that asks whether to 
update the name context in the NET.CFG file. 


You can execute NCUPDATE at the command line, but it is 
designed to be run from a container login script. 


When you move or rename a container object using NetWare 
Administrator or NETADMIN, you can create an alias that points 
to the moved or renamed container. 


An alias allows users who don’t know the container has been 
moved or renamed to continue seeing the container (and the 
objects in it) by its original name or in its original location. 


In addition, an alias allows users whose name context in their 
NET.CFG file refers to the moved or renamed container to 
continue to be able to log in, even though their actual context in 
the Directory tree has changed. 


NCUPDATE 





Examples 


Since moving or renaming a container object changes the context 
of both the container and any users below the container, users in 
and below that container must update their name context in their 
NET.CFG file. 


To automatically update user NET.CFG files, place a command to 
execute NCUPDATE in the login script of the moved or renamed 
container and every container in and below it. 


When users who are in or below the moved or renamed container 
log in, LOGIN will recognize that the context used to log in 
contains an alias. Then LOGIN will set the internal script variable 
LOGIN_ALIAS_CONTEXT to Y. 


The network supervisor can place a command to run NCUPDATE 
in the login script of a container using NetWare Administrator or 
NETADMIN. 


The network supervisor—or a user with the Supervisor object right to the 
moved or renamed container—can place the following lines in the login script 
of the container and every container in and below the container: 


IF LOGIN_ALIAS_CONTEXT = Y THEN BEGIN 
MAP INS S1:=<server name >/SYS:PUBLIC 
#NCUPDATE /NP 
MAP DEL S1: 


END 


When users log in to the server using an alias context, NCUPDATE updates 
each user's name context in the NET.CFG file. 


NCUPDATE updates the NET.CFG file. The location of this NET.CFG file on 
users’ workstations may vary, so the path to the NET.CFG file that will be 
updated is listed on the screen as NCUPDATE executes. 


In the example login script, the supervisor maps a temporary search drive to 
SYS:PUBLIC so the container login script can locate NCUPDATE.EXE in the 
PUBLIC directory. Then the search drive is deleted. 
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The supervisor deletes the /NP in the example login script if he or she wants 
the users to be prompted to update their NET.CFG files. 


Once all user NET.CFG files are updated, the supervisor deletes the alias that 
points to the moved or renamed container. 


Additional Information 





Topic See 

Alias objects Alias object in Concepts . 

Login scripts About Login Scripts in Supervising the 
Network . 

Moving container objects Moving Objects in the Directory Tree in 


Supervising the Network . 


Renaming container objects Renaming Leaf and Container Objects in 
Supervising the Network . 


162 Utilities Reference 


NDIR 





NDIR 


Purpose 


Syntax 


Use at a workstation to 


@ View information about files (date, size, owner, attributes, archive 


information) 


@ View information about directories (creation date, owner, 
subdirectories, Inherited Rights Filter, effective rights) 


@ View volume information 


@ Sort information according to creation date, owner, file or 
directory attributes, etc. 





NDIR [path ] [/option... ] [/? | /VER] 
Parameter Use to 
path Specify the path leading to the information you 


/option 


/? 


want to view. Include the volume, directory, or 
filename. 


Replace option with any available option. See 
the following NDIR options: 


“NDIR Display Options”, 
“NDIR Format Options’, 
“NDIR Sort Options”, 
“NDIR Attribute Options”, 
“NDIR Restriction Options” 


View online help. All other parameters are 
ignored when /? is used. 
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Using NDIR 


NDIR Display Options 
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Parameter 





Use to 





/VER 


View the version number of the utility and the 
files it uses to execute. All other parameters are 
ignored when /VER is used. 


@ A forward slash (/) must precede the first option of the option list. 
Use backslashes (\) in pathnames. 


@ You can use several options, but separate the options by spaces. 


@ To view several files in your default directory, include a comma 


between filenames. 


@ You can use wildcard characters. 








Option Use to 

DO Sort and view directories only. 

FO Sort and view files only. 

Fl View every occurrence of the specified files 
within your current directory and your PATH 
environment. 

SUB Sort and view all subdirectories and their files. 

VOL View volume information for the specified 
volume. 

SPA View directory space limitation information for 
the specified directory. 

C Scroll continuously through a display. 


NDIR 





NDIR Format Options 


NDIR Sort Options 








Option Use to 

DA View dates when files were last updated, 
archived, accessed, created, and copied. 

DE View file details. 

COMP View file and compression sizes for NetWare 4 
files. 

LONG View name space long filenames. 

R View file attributes, the compression and 
migration status, your effective rights, and the 
rights allowed to pass through the Inherited 
Rights Filter. 

Option Use to 

REV Reverse the direction of a sort. Put REV before 
SORT. Example: /REV SORT OW. 

SORT CR Sort by creation or copy date, from earliest to 
latest. 

SORT UN Suspend sorting. 

SORT AC Sort by date last accessed, from earliest to 
latest. 

SORT AR Sort by date last archived, from earliest to 
latest. 

SORT UP Sort by last update, from earliest to latest. 

SORT OW Sort alphabetically by file owner names. 

SORT SI Sort by file size, from smallest to largest. 
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NDIR Attribute Options 
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Option 
(option name) 


Use to 





NOT 


A 
(Archive Needed) 


Di 
(Delete Inhibit) 


Dc 
(Don’t Compress) 


Dm 
(Don't Migrate) 


Ds 
(Don’t Suballocate) 


X 
(Execute Only) 


H 
(Hidden) 


Ic 


(Immediate Compress) 


P 
(Purge) 


View files that don’t have a specified attribute. 
For example, to display all files in the current 
context that do not have the Di (Delete Inhibit) 
attribute, type: 


NDIR *.* /NOT /DI 


View files modified since the last backup. 


Prevent the file from being deleted. 


Prevent the file from being compressed 
(regardless of what the volume or directory is 
set to). 


Prevent the file from being migrated to a 
secondary backup (regardless of what the 
volume or directory is set to). 


Prevent an individual file from being 
suballocated, even if suballocation is enabled 
for the system. 


Prevent a file from being copied or copied over. 
This attribute can be given only to .EXE or 
.COM files, and cannot be removed. 

Prevent a file from being seen with the DOS 
DIR command. The file can’t be copied or 
deleted. 


Compress a file as soon as possible. 


Purge a file immediately if the file is deleted. 





NDIR 








Option 
(option name) 


Use to 





R 
(Rename Inhibit) 


Ro 
(Read Only) 


Rw 
(Read Write) 


S 
(Shareable) 


Sy 
(System) 


T 
(Transactional) 


Prevent a file from being renamed. 


Allow a file to only be read—it can’t be written 
to or deleted. 


Allow a file to be read and written to. 


Allow a file to be used by several users 
simultaneously. 


Prevent a file from being seen with the DOS 
DIR command. The file can’t be copied or 
deleted. 


Protect a file by using the Transaction Tracking 
System (TTS). 





NDIR Status Flags 


Status flags provide you with information only. You can’t change them. 


Flag 
(flag name) 


This flag means 





Cc 
(Can't Compress) 


Co 
(Compressed) 


M 
(Migrated) 


The file won’t be compressed because of 
limited space savings. 


The file is compressed. 


The file has been migrated. 
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NDIR Restriction Options 


Examples 
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Option 
(option name) 


Use to 





[NOT] 
(Not) 


ICR BEF | EQ | AFT mm-da- 


yy 
(Creation date) 


JAC BEF | EQ | AFT mm-dd- 


yy 
(Last access) 


JAR BEF | EQ | AFT mm-dd- 


yy 
(Last archive) 


/UP BEF | EQ | AFT mm-dd- 


yy 
(Last update) 


/OW EQ user 
(Owner) 


/SI GR | EQ | LE number 
(Size) 


View all files except those the option specifies. 


Syntax: /CR [NOT] BEF | EQ | AFT 
mm-dd-yy 


View files created on, before, or after the date 
specified. 


View file last accessed before, on, or after the 
date specified. 


View files last archived on, before, or after the 
date specified. 


View files last updated on, before, or after the 
date specified. 


View files created by a specific user. 


View files with byte sizes greater than, equal to, 
or less than a specified number. 


@ To view all files in the current directory, type 


NDIR *.* 


@ To view the version of all .EXE files on drive Z:, type 


NDIR Z:\*.EXE /VER 


@ To view only directories on drive F:, type 


NDIR 





NDIR F:\*.* /DO 

To view rights for all files in the current directory, type 
NDIR *.* /R 

To view the date of file RECORD.TXT, type 

NDIR RECORD.TXT /DA 

To view detailed file information on RECORD.TXT, type 
NDIR RECORD.TXT /D 

To view all Read Only files in SYS:PUBLIC, type 

NDIR SYS:PUBLIC\*.* /RO 

To search for all batch files on drive C:, type 

NDIR C:\*.BAT /SUB 


To search (from the root) all subdirectories on your current drive 
for TEXTUTIL.MSG, type 


NDIR TEXTUTIL.MSG /S 


To view all files in the current directory that are not Read Only, 


type 
NDIR *.* /NOT RO 


To view all files on the current directory by file size from smallest 
to largest, type 


NDIR *.* /SORT SI 


To view all files in drive Z: by the most recent access date first, 


type 


NDIR Z:*.* /REV SORT AC 
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@ To view all files updated before June 5, 1998, type 
NDIR *.* /UP BEF 6-05-98 
@ To view all files not owned by user PAT, type 
NDIR *.* /OW NOT EQ PAT.SALES 
You must type the user’s complete name. 
+ To find where COMMAND.COM is located, type 


NDIR COMMAND .COM /FI 


Additional Information 





Topic See 
Complete name Context in Concepts. 
Transactional attribute Attributes in Concepts . 


File and directory attributes Attributes in Concepts. 


“FLAG” 
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NDS Manager 


Purpose 


Use at a Windows 3.1x, Windows 95/98, or Windows NT workstation to 
manage Novell Directory Services (NDS) partitions and replicas on a NetWare 
server. 


NDS Manager provides 


¢@ Partitioning and replication services for the NDS database, as well 
as repair capabilities for repairing the database from a client 
workstation 


@ Server and workstation services at a single client location, which 
reduces the need for administrators of NDS to use RCONSOLE or 
to work directly with a server console 


@ Version update capability so that any or all NetWare servers ina 
network can be updated to a newer version of the DS.NLM 


NDS Manager replaces the Partition Manager utility that was accessed from the 
Tools menu in the NetWare Administrator utility in earlier versions of the 


NetWare 4 operating system. NDS Manager has a graphical, hierarchical 
browser and many new features that were not available in Partition Manager. 


Starting NDS Manager 
NDS Manager can be run as a standalone executable from SYS:PUBLIC. 
You can also configure NDS manager to run as a tool under the Tools menu in 


NetWare Administrator. For instructions, see Setting Up NDS Manager in 
Supervising the Network . 


Using NDS Manager 
NDS Manager’s Help system provides complete documentation. In the Help 


you will find overview information, procedural information, and context- 
sensitive help. 


Chapter 2: Utilities 171 


NDS Manager 





To get help from a view in NDS Manager, click the ? icon in the toolbar. For 
help on a specific dialog box, choose the Help button. To browse the Help 
contents, choose Contents from the Help menu. 
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NETADMIN 


Purpose 


Use at a workstation to manage Novell Directory Services (NDS) objects and 
their properties. Users can view, create, move, delete, and assign rights to any 
NDS object under their jurisdiction. 


You can’t manage printing and file system environments from NETADMIN. Use 
PCONSOLE and FILER, respectively. 


“NETADMIN Functions” on page 173 shows the functions you can select 
from the NetAdmin Options main menu. 


Figure 2-6 
NETADMIN Functions 





Allows you to manage: 
e Objects 


NetAdmin Options 


e Properties Manage ob jects 
e Object rights Manage according to search pattern 


e File system rights nek context 
earc 















e Select individual or groups of 
objects to view or manage 


e Select to view Alias objects 


Change where you are in the 
Directory tree structure. 





Search for any NDS object or 
object class. Wildcards 
allowed. 


Syntax 


NETADMIN [/VER] 
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Parameter Use to 





/VER View the version number of the utility and the 
list of files it uses to execute. 


For help with tasks, press <F1> while you are in the utility. 


Using NETADMIN 


NETADMIN displays information in windows, representing layers of the 
Directory tree. You can select the level of the tree in either of two ways: 
browsing the tree or choosing Search from the main menu. 


Using the Browse Screen 


Browsing is selecting objects to work with by moving through the Directory 
tree. As shown in the following figure, you select a container and press 
<Enter> to open it. When you have found the object you want, highlight it and 
press <F10> to view the available options. 


174 Utilities Reference 


NETADMIN 





Figure 2-7 
NETADMIN Browse Screen 





(parent) 
3 (current context) 
+Servers (Organizational Unit) 
Esayers (User) 
jal jemand Objects without + are leaf objects and pled tory Map) 
uniter can't contain other objects. (Group) 








This option lets you view or edit the properties 
of the current container object. 

This option lets you browse up the Directory tree 
to the parent container level. 


Use the following table as a guide in browsing the tree. 











To Do this 





Browse up the Directory tree Choose .. (parent). 
to the parent container 


View or edit the properties of Select . (current context) and press <F10>. 
the current container object 


Browse down the Directory Choose objects with a plus (+) in front of them. 
tree When you choose a container object, you can 
see the objects in that container. 


View or modify an objects = Press <F10> on the object. 
properties 
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Searching for an Object 


Figure 2-8 
Search Criteria 


You can define where and what you want to search for. The following figure 
shows elements that can be defined for a search. 





Context: 
Search Depth: 


All containers in all sub-trees 
Class: /All classes/ 


Property: 
Operator: 
Value: 





Highlight each field to define the required criteria and press <Enter> . When 
all fields are defined properly, press <F10> to start the search. All objects 
found are displayed in a new window. 


Select the appropriate object and press <Enter >. From the Actions for: menu, 
select View or Edit Properties or View or Edit Trustees of This Object. 


Managing Object Properties 
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All objects have properties that define them. Some properties are mandatory. 
You must specify their values before the object can be created. (Mandatory 
properties are listed on the screen where you create a new object.) 


Other properties are optional; they help define the object or help you search for 
an object. 


The following screen appears when you press <F10 > to view or edit an 
object’s properties. The last name and login name are mandatory for the User 
object. 


NETADMIN 





Figure 2-9 
User Properties 








Identification information 


Login Name: scott 


Last name: jones 
Other name: (Empty List) 


Title: 


(Empty List) 


Description: 
Telephone: (Empty List) 
Fax number: (Empty List) 


Location: 


(Empty List) 


Department : (Empty List) 


Assigning Rights 





The arrow indicates that there can 
be more than one item for this field. 


Select this field and press <Enter> 
to view the list. 


After you select an object, you can view or change access rights by 
@ Changing that object’s rights to files on a volume 


@ Changing who has rights to view or change the properties of that 
object 


Rights to Files and Directories 
To make trustee assignments, you must choose the level of the Directory tree 


you want. “View or Edit Object Rights” shows the window where you will 
make this choice. 
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Figure 2-10 
View or Edit Object Rights 


Rights to files and/or directories 


Volume object name: 
Beginning Path: 





Directories/Files: Directory 
Trustee Search Depth: All subdirectories 





@ After you select a volume object and its path, all of the object’s 
trustee assignments in that directory are listed. You can change the 
rights granted, or add or remove other trustee assignments. 


@ You must have the Access Control right to a file or directory to 
change an object’s rights to it. 


¢@ For procedures to perform these tasks, press <F1> in the utility. 


Rights to Objects 


If you select View or Edit the Trustees of this Object from the Actions for 
Organizational Role: menu, and then select Trustees, the following screen 
appears, listing all trustee assignments that grant rights to access this object and 
its properties. 


@  Youcan change the rights that any trustee has to this object, or add 
and delete trustee assignments from the list. 


@ You can also view or change the Inherited Rights Filter of the 
object, if you have sufficient rights. 
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Figure 2-11 
Trustee Assignments 





Property Rights Trustee 


Login Script 

Message Server [Public] 
[All Property Rights] Admin 
[Ob ject Rights] [Root J 





Example: Assigning Rights to Objects and Properties 


If you press <Ins> at the screen shown in the previous figure, a screen appears, 
allowing you to select a property (or the object) that a new trustee should be 
granted rights to. 


To change the trustees who have rights to it, you must have at least the Write 


property right to the ACL property of this object. (For procedures to perform 
these tasks, press <F1> while you are in the utility.) 


Creating User Templates 


If you need to create many users in the same container who need some of the 
same information in their properties, you can create a user template. 


A user template is an object that contains default information that you can 
apply to users when you create them. This makes creating a large number of 
users easier. 

You can create a user template in any Organization or Organizational Unit. 
When you create an Organization or Organizational Unit, you are asked if you 


want to create a user template. 


Press <F1 > to get more information. 
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Examples 


Create Objects 


1. Select Manage Objects; browse the Directory tree and select 
the container object where the new object will be located. 


2. Press <Ins> and select the object type. 


3. Press <F1> for help from here. 


Edit User Password Expiration Date 


1. Select Manage Objects; highlight the user object and press 
<F10>. 


2. Select View or Edit Properties of This Object; select Account 
Restrictions; then select Password Restrictions from the 
menu. 


3. Press <F1> for help from here. 


Manage Directory and File Rights for an Object 


1. Select Manage Objects; highlight the object and press <F10> 


2. Select View or Edit This Object’s Rights to Files and 
Directories. 


3. Press <F1> for help from here. 


Manage Other Objects’ Rights for an Object 


1. Select Manage Objects; highlight the object and press <F10> 


2. Select View or Edit Trustees of This Object. 


3. Press <F1> for help from here. 
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Modify Object Properties 


1. Select Manage Objects; highlight the object whose properties 
you want to modify and press <F10>. 


2. Select View or Edit Properties of This Object; select the 
property to modify, such as Groups, Login Script, Account 
Restrictions, etc., from the menu. 


3. Press <F1> for help from here. 


Move Objects to Another Location in the Directory Tree 


1. Select Manage Objects; highlight the object you want to move 
and press <F10>. 


2. Select Move from the menu. 


3. Press <F1> for help from here. 


Additional Information 





Topic See 

Objects Object in Concepts 

User template User template in Concepts . 
Container objects Container object in Concepts . 
Leaf objects Leaf objects in Concepts . 
Context Context in Concepts . 
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NETSYNC3 


Purpose 
Load at a NetWare 3 file server console to enable the NetWare Bindery 
Synchronizer. 
You need to load NETSYNC4 on the NetWare 4 server before loading 
NETSYNC38 on the NetWare 3 servers. 

@ Copies (uploads) the NetWare 3 server’s bindery information to 
the NetWare 4 server’s bindery context, and then continues to 
communicate with the NetWare 4 server in order to receive 
updates to Directory information. 

@ Moves printing objects and converts the NetWare 3 PRINTDEF 
database into a NetWare 4 -compatible database. 

@ Creates a working directory (NETSYNC) for the NetSync™ log 
files under SYS:SYSTEM. 

@ NETSYNCS3 should run continuously, so you should add it to the 
AUTOEXEC.NCF file on the NetWare 3 server. 

Syntax 


LOAD NETSYNC3 


For help with tasks, press <F1> in the utility. 


Additional Information 


For information on See 





Installing and Using NETSYNC3 Installing and Using NetSync . 
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NETSYNC4 


Purpose 


Syntax 


Load at the NetWare 4 host server console to enable the NetWare Bindery 
Synchronizer. 


@ Authorizes NetWare 3 servers to be part of the NetSync cluster. 
@ Receives information from the NetWare 3 binderies in its cluster, 


and then continually copies (downloads) updated Directory 
information to all of the attached NetWare 3 servers. 


LOAD NETSYNC4 


For help with tasks, press <F1> in the utility. 


Additional Information 





Topic See 





Installing and Using NETSYNC4 Installing and Using NetSync . 
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NETUSER 


Purpose 


Use at a workstation to manage network tasks. 


Figure 2-12 
NETUSER Functions 


Allows you to: 


e Capture ports to printers or print queues 


e Sends, modifies, pauses, and deletes 
print jobs after a port is captured. 








Allows you to: 





e Send messages to users or groups 
e Disable or enable incoming messages 





fAuailable Options 









Printing 





Messages 
Drives 
Attachments 
Change Context 





Allows you to: 








e Manage drive and search mappings 
e View your effective rights on 
selected drives 





Allows you to: 


Manage network attachments 
Change your password 

View server information 
Change your login script 





Allows you to set your current context 
if you are logged in to a Directory tree. 





Syntax 


NETUSER [/VER] 
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Parameter Use to 





/VER View the version number of the utility and the 
list of files it uses to execute. 


For help with tasks, press <F1> in the utility. 


Examples 


Capture a Printer 
1. Select Printing. 
2. Select the printer port from the available list. 
3. Select Change Printers. 


4. Press <F1> for help from here. 


Print a Job 
1. Select Printing. 
2. Select Print Jobs. 


3. Press <F1> for help from here. 


Send Messages 
1. Select Messages. 
2. Select Send Messages to Users or Send Messages to Groups. 


3. Press <F1> for help from here. 
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Map a Drive 


Change a Password 


Attach to a NetWare Server 


1. 


Additional Information 





Select Drives. 
Select Drive mappings or Search mappings. 


Press <F1> for help from here. 


Select Attachments. 


Select the NetWare server and the username for which you 
want to change the password. 


Select Password. 


Press <F1> for help from here. 


Select Attachments; press <Alt><F1> to display more options 
at the bottom of the screen. 


Press <Ins> to display a list of available servers. 


Press <F1> for help from here. 


Topic See 





NetWare User Tools in DOS The Novell Client documentation. 
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NetWare Administrator 


Purpose 


From a workstation running Windows 3.1x, Windows 95/98, or Windows NT 
use this utility to perform the following supervisory tasks.: 


@ Create users and group 

@ Create and delete Novell Directory Services (NDS) objects 
@ Move and rename NDS objects 

@ Assign rights in the Directory tree and in the file system 
@ Set up printing services 

@ Set up licensing services 


NetWare Administrator incorporates all the functions available in FILER, 
NETADMIN, PARTMGR, and PCONSOLE. 


Starting NetWare Administrator 


During installation, files for the Windows 3.1x NetWare Administrator are 
copied to the SYS:PUBLIC directory. For the Windows 95/98 NetWare 
Administrator, the files are copied to the SYS:PUBLIC\WIN95 directory. For 
the Windows NT NetWare Administrator, the files are copied to the 
SYS:PUBLIC\WINNT directory 


Before you start NetWare Administrator for the first time, create an 
NWADMIN icon. Thereafter, you can choose the icon to start the utility. 


For instructions, see Setting Up Administration Utilities in Supervising the 
Network . 
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Using NetWare Administrator 


Using the Menu Bar 


Figure 2-13 


NetWare Administrator has a graphical user interface (GUI) and runs as a 
multiple-document interface (MDI) application. 


For help in NetWare Administrator, choose the Help button on the screen, press 
<F1> , or use the pull-down Help menu. 


The menu bar displays headings for several menus. To complete a task, you 
first select an object in the browser, next select a menu heading, and then 
choose the option you want to use in the menu. 


NetWare Administrator Menu Bar 





=| Object View Options Tools Window Help + 


Using the Browser 


Working with Objects 
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Each time you select a menu option, a message appears in the title bar 
explaining briefly what the menu option does. If an option is grayed, it is not 
available for the object you selected. 


When you launch NetWare Administrator, you will notice that its primary 
window is a browser that displays the Novell Directory Services (NDS) 
container objects and leaf objects at your current context in the Directory tree. 


You can open up to nine additional browsers. You might want to open an 
additional browser to see a different context in the Directory tree. 


To open another browser, select a container object (this will be the root object 
in the browser window) and, from the Tools menu, select Browser. 


@ To view the file system of a server in your tree, double-click on the 
Volume object associated with that server. 


For example, to see the file system in the SYS: volume of server 
KATT, double-click on the Volume object KATT_SYS. 


NetWare Administrator 





@ To open a container object and view the objects in it 


+ Double-click anywhere on the container object’s name or 
icon. 


+ Select the container object and, from the View menu, choose 
Expand. 


@ To view the object dialog (object details) of a container object 


+ Select the container object and from the Object menu, choose 
Details. 


+ Select the container object, right-click once, and choose 
Details from the short menu that appears. 


@ To view the object dialog (object details) of a leaf object 
+ Select the leaf object and double-click. 


+ Select the leaf object and from the Object menu, choose 
Details. 


+ Select the leaf object, right-click once, and choose Details 
from the short menu that appears. 


Using the Object Dialog 


The object dialog allows you to view and edit information about an object’s 
properties. When you open an object details dialog box, you see property pages 
along the right side of the dialog box. Although you view these pages one at a 
time, they are all part of one dialog. When you select a different page, you’re 
still in the same dialog. 


The property pages are configurable; you can order them however you like. To 
change the page order, click Page Options, and from the Page Options dialog, 


sort the property pages according to your specific needs. 


The Identification page is the first page you see when you open an object 
dialog. Figure 2-14 shows the Identification page of a User object. 
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NetWare Administrator 





Figure 2-14 
Identification Page 





Dialog name 





Shows object class: 
name of object. 





Page title 


Identification 





















Login Hame: esmith 


Identification 





Given Hame: | Emily 


Environment 








Last Hame: | smith 


Login Restrictions 















Displays the name of 
the selected page. 


Page area 


Full Hame: Loo E] 





Generational . 7 
Qualifier: [| Middle Initial: a 


Password Restrictions 


Login Time Restrictions 





Other Name: Loo B m) 


D 
Network Address Restrictio 















Displays fields for different 
information when page 
buttons are selected. 


OK & Cancel 


Description : : 





A 
Foreign EMail Address 





Location: | 


Bi 





Print Job Configuration 





Telephone: — ase 








Important: These buttons 
affect all pages, not just 
the page displayed. 






El 
Department: H Ed 
El 
Fax Humber: H m) 


Login Script 


























Additional Information 





Topic 





See 
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Creating container objects 
with NetWare Administrator 


Creating leaf objects with 
NetWare Administrator 


Moving objects with 
NetWare Administrator 


Assigning rights to the file 
system in NetWare 
Administrator 


Creating Container Objects in Supervising the 
Network . 


Creating Leaf Objects in Supervising the 
Network . 


Moving Objects in the Directory Tree in 
Supervising the Network . 


Understanding File and Directory Rights in 
Supervising the Network . 


NetWare Administrator 











Topic See 

Assigning rights to NDS Managing Trustee Assignments to Objects in 
objects Supervising the Network . 

Printing in NetWare Managing Print Services with the NetWare 
Administrator Administrator Utility in Print Services . 


Managing NDS partitions “NDS Manager” 
and replicas and NDS repair 
functions (from the client) 


Managing the High Capacity Migrating Data Using the High Capacity 
Storage System Storage System in Supervising the Network . 


Managing licensing services Managing NetWare Licensing Services in 
Supervising the Network . 


“NLS Manager” 
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NetWare Application Launcher 


Purpose 


Use at a Windows 3.1x, Windows 95/98, or Windows NT workstation to run 
applications associated with Application objects. 


Starting NetWare Application Launcher 


Open the NetWare Application Launcher™ (NAL) program group in 
Windows 3.1x or the NAL folder in Windows 95/98 or Windows NT. 


Using NetWare Application Launcher 


An Application object is an extension to the NetWare schema that allows you 
to manage applications the same way you manage other objects. 


Application objects require Novell Directory Services for their functionality. You 
cannot run applications associated with Application objects if you are using a 
bindery connection. 


NetWare Application Launcher runs on the desktop, allowing the user to view 
Application objects and run the associated application. Application objects that 
the network supervisor creates and manages appear as NetWare-delivered 


applications in the main window of NetWare Application Launcher. 


Use NetWare Application Manager to create and manage Application objects. 


Additional Information 








Topic See 

Installing NetWare Application SYS:PUBLIC\NLS\ENGLISH\ 
Launcher NAL.HLP 

Creating Application objects “NetWare Application Manager” 
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NetWare Application Manager 


Purpose 
Use to create and manage Application objects. NetWare Application 


Manager™ runs under NetWare Administrator on Windows 3.1x, Windows 
95/98, or Windows NT workstations. 


Using NetWare Application Manager 
An Application object is an extension to the NetWare schema that allows you 
to manage applications the same way you manage other objects, using NetWare 


Administrator 


Application objects require Novell Directory Services for their functionality. You 
cannot work with Application objects if you are using a bindery connection. 


To create an Application object, first run NetWare Administrator and create an 
object. NetWare Administrator displays a list of object classes you can choose 
from. Choose the class appropriate for the application executable. Then assign 
the appropriate properties to the Application object for your network. 
Application object classes include the following: 

@ DOS 

@ Windows 3.1x 

@ Windows 95/98 

@ Windows NT 
By setting an Application object’s properties, you enable the executable 


associated with the Application object to allocate resources such as drive 
mappings or printer ports. Properties you can set include the following: 





Property Use to 





Identification Set icon title, path to executable file. 
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Property Use to 





Environment Set command-line parameters, 
working directory. 


Drives/Ports Set drive mappings and port 
captures. 

Description Describe the application (optional). 

Scripts Define prelaunch setup and post- 


termination cleanup scripts. 


Contacts Define a technical support contact for 
the application. 


Associations Define associations with User and 
container objects. 


Application objects appear as NetWare-delivered applications in the main 
window of NetWare Application Launcher. 


Additional information 








Topic See 

Installing NetWare Application SYS:PUBLIC\APPSNAP.HLP. 
Manager 

NetWare Application Launcher “NetWare Application Launcher” 
NetWare Administrator “NetWare Administrator” 
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NetWare File Migration 


Purpose 
Use at a Windows 3.x, Windows 95/98, or Windows NT workstation to migrate 
files from NetWare 3.1x servers to NetWare 4 servers. The NetWare File 


Migration utility is used after the NetWare 3.1x bindery has been migrated 
using the INSTALL.NLM. 


Starting NetWare File Migration 


NetWare File Migration runs under NetWare Administrator. Start NetWare 
Administrator and then, from the Tools menu, choose File Migration. 


Additional Information 


Topic See 





Upgrade and Migration Installation and Upgrade 
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NetWare Login 


Purpose 
Use at a Windows 3.1x, Windows 95/98, or Windows NT workstation to 
@ Access a Novell Directory tree or a NetWare server 


@ Runa login script 


Starting NetWare Login 


By default, NetWare Login runs when you start Windows. However, you can 
start NetWare Login any time by choosing its icon in Windows. 


Depending on your Windows platform, type the appropriate executable 
filename: either LOGINW31 or LOGINW95. 


Example: loginw95 /a 


An additional parameter, /A, is provided to cause the advanced tabs to appear 
in the NetWare Login dialog box. 


Using NetWare Login 


Use the options provided in the NetWare Login dialog box or in your Client 32 
settings. For more information, see the online Help for NetWare Login. 


Additional Information 








Topic See 

NetWare Login dialog box Online Help within the dialog box. 
Command-line options “LOGIN” 

Client 32 settings Online Help within the dialog box. 
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NetWare User Tools 


Purpose 


Use at a client workstation running Windows 3.1x to complete tasks that use 
network resources. These tasks include: 


+ 


+ 


+ 


Capturing a printer 

Printing 

Sending a network message 

Mapping a drive 

Changing a password 

Attaching to a NetWare server 

Authenticating to a Novell Directory Services tree 


Changing NetWare Client settings 


Starting NetWare User Tools 


During installation of NetWare Administrator, NetWare User Tools is copied to 
the SYS:PUBLIC directory. During installation of NetWare Client 32 on the 
Client workstation, the setup program creates a Program Manager group called 
NetWare Tools and adds to it the NetWare User Tools icon. 


There are two ways to start NetWare User Tools: 


+ 


Double-click the NWUser icon in Program Manager or File 
Manager 


Under the File pull-down menu in Program Manager or File 


Manager, choose Run. In the Run dialog box, type the full path to 
NWUser on the network server and click OK. 
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Using NetWare User Tools 


Using the Tool Bar 
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Like the NETUSER text-based utility, NetWare User Tools allows you to 
complete tasks with network resources. But in contrast to NETUSER, NetWare 
User Tools uses a graphical user interface. The interface’s main window 
contains the following areas: 


+ 


Tool bar 


Displays buttons with icons that represent the task categories 
available in User Tools. 


Resources browser and buttons 


The browser displays resources available in the current task and 
operations you can complete as part of the current resources. It 
also displays the current task in a status text field. 


The resources buttons allow you to perform operations on current 
resources. 


Tabbed settings notebook (Client 32 workstations only) 


Displays NetWare and User Tools settings, Client startup tasks, 
and login options. 


The tool bar displays buttons with icons representing the tasks available in User 
Tools. To work on a task, click the button that represents the task. 


For help in using NetWare User Tools, press <F1> or click the Help button on 
the tool bar. 


When the cursor moves over a button on the tool bar, the status text field in the 
resources window displays the description of that button’s task. When you 
double-click a button on the tool bar, the window title bar displays the 
description of that button’s task. 


NetWare User Tools 





Using the Resources Window 


The resources browser displays the current resources in use in the left column 
and the available resources in the right column. Current resources include drive 
connections (or mappings), printer port mappings, and Novell Directory 
Services connections. 


To use an available resource, drag it from the right column to the left column. 
For example, when NetWare User Tools is launched, the default resources 
browser displays the current drive mappings in one column and NetWare 
resources in the other. To create a new drive mapping, drag a NetWare resource 
from the right column and drop it on a drive letter on the left column. 


Double-clicking a current resource displays information about that resource. 
For example, double-clicking a current drive mapping displays information 
about the connection, such as the NetWare version, the path, the current user 
name, and effective rights. 


You can use the resources buttons to modify the properties of resources. For 
example, when you drag a printer from the resources list and drop it on a port, 
you can change the settings of the port, make the printer port capture 
(connection) permanent, or end the capture. 


To map a drive or capture a printer port without dragging and dropping 
resources, choose the drive letter or port from the left column, choose the 
network volume or printer resource from the right column, then click the Map 
or Capture resource button. 


Using the Tabbed Settings Notebook 


The tabbed settings notebook is available in NetWare User Tools on Client 32 
workstations. It displays NetWare settings you can modify. 


To modify a NetWare setting, click on the notebook tab for the settings 
category you want. Categories include how User Tools displays resources and 
maps drives; how the NetWare Client displays network messages and jobs in 
the print queue; what tasks the NetWare Client completes at startup; and login 
options. 


On 16-bit workstations, some of these settings can be modified by clicking the 
Key button on the tool bar. 
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Additional Information 


Topic See 





NetWare User Tools in Windows Online Help. 


Novell client documentation. 
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NIT 


Purpose 


NIT.NLM provides a set of NetWare interface tools needed by other NLM 
programs. You don’t need to load NIT.NLM; it’s autoloaded by any module that 
needs it. 


See “CLIB” on page 44 for more information. 
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NLIST 


Purpose 


Use at a workstation to 


@ View information about objects such as users, groups, volumes, 


servers, etc. 


@ Search on objects and object properties 


Syntax 


NLIST [class type 
[object name ] 


11 | 
[/? | /VER] 


Parameter 


[property search option J 
[/basic option ] [display option 


Use to 





class type 


property search option 


object name 


/basic option 


display option 
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Specify an object type, such as USER, 
SERVER, PRINTER, GROUP, VOLUME, etc. 


For bindery servers (NetWare 3), replace class 
type with USER, SERVER, QUEUE, GROUP, 
or VOLUME. 


These are the only objects available in bindery 
services mode for NetWare 3. 


Specify a search option. For online help, type 
NLIST /? R. 


Specify the name of the object you want 
information about. 


Specify any available option. See “NLIST 
Options” 


Select how data is displayed. For online help, 
type NLIST /? D. 


NLIST 








Parameter 


Use to 





/? 


/VER 


View online help. All other parameters are 
ignored when /? is used. 


View the version number of the utility and the 
files it uses to execute. All other parameters are 
ignored when /VER is used. 





NLIST Options 


Option 


Use to 





A 


B[= server name | 


C 


CO[=context ] 


SHOW]|[property ] 


TREE 


View users who are logged in. 


View information stored in the bindery of the 
specified server. (Bindery servers only.) 


Scroll continuously through information. 


Set the context to be searched (NDS servers 
only). 


View all object properties. 
View object names. 


Search all levels of the database, beginning at 
the current context. 


View a specific property of an object. 


View all tree names visible from this login. 





Using NLIST 


@ Searching on objects and properties allows you to view specific 


groups of objects. 
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For example, you can view all users whose passwords will expire 
on a certain date. Or you can view all groups that have a particular 
user as a member. 


You can use Property groups only with a bindery connection, or 
with bindery services. 


USER, SERVER, QUEUE, GROUP, and VOLUME are the only 
objects you can search on in a bindery context. 


Table 2-4 , NLIST Syntax, shows the syntax for some of the most 
frequently use NLIST operations. 


For detailed information on the parameters in this table, see the 
online help. 


NLIST 





Table 2-4NLIST Syntax 
To list 


Use this syntax 





Any information 


User information 


Server information 


Group information 


Printer information 


Print Queue information 


Volume information 


Object information 


Bindery object 
information 


NLIST [class type ] [=object name ] [/option ...] 


NLIST user=[username ] [WHERE [property ] [operator ] [value ]] [SHOW 
[property ]] [/option ...] 


For bindery servers, use [property group | instead of [property ] 


NLIST server=[server name ] [WHERE [property ] [operator ] [value ]] [SHOW 
[property ]] [/option ...] 


For bindery servers, use [property group | instead of [property ] 


NLIST group=[group ] [WHERE [property ] [operator ] [value ]] [SHOW 
[property ]] [/option ...] 


For bindery servers, use [property group | instead of [property ] 


NLIST printer=[printer ] [WHERE [property ] [operator ] [value ]] [SHOW 
[property ]] [/option ...] 


For bindery servers, use [property group | instead of [property ] 


NLIST queue=[queue ] [WHERE [property ] [operator ] [value ]] [SHOW 
[property ]] [/option ...] 


NLIST volume=[volume ] [WHERE [property ] [operator ] [value ]] [SHOW 
[property ]] [/option ...] 


NLIST [class type ] [=object name ] [WHERE name [operator ] [value 1] | 
WHERE object] [operator | [value 2]] [/option ...] 


NLIST /OT [=value] [WHERE name [operator ] [value 1] | WHERE object] 
[operator | [value 2]] [/option ...] 





Examples 


Users 


@ = To list all users whose password length is less than 5, type 


NLIST USER WHERE PASSWORD MINIMUM LENGTH LT 5 
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To list all users whose accounts will expire by June 30, 1998, type 
NLIST USER WHERE ACCOUNT EXPIRATION LE 06-30-98 
To list all users who are members of group MANAGERS, type 
NLIST USER WHERE GROUP MEMBERSHIP = MANAGERS 

To list all users logged in, type 

NLIST USER /A 

To list all users who have supervisor equivalence, type 

NLIST USER WHERE SECURITY EQUAL TO = SUPERVISOR 
To list all properties of user CINDY, type 

NLIST USER=CINDY /D 

To list all users managed by JOE (bindery users only), type 
NLIST USER WHERE MANAGERS=JOE 

To list users logged in to the database, type 

NLIST USER /A /S 

To list properties of users in the current context, type 

NLIST USER /D 


To list the login script of every user who has a login script in all 
contexts, type 


NLIST USER SHOW LOGIN SCRIPT /S 


To list users whose telephone numbers begin with 4 (search all 
subordinate containers), type 


NLIST USER WHERE TELEPHONE NUMBER = 4* /S 


NLIST 





Servers 


To list users at a context, type 
NLIST USER /CO <context > 
To list telephone numbers of all users in the current context, type 


NLIST USER SHOW TELEPHONE NUMBER 


To list servers running NetWare 4.2 , type 


NLIST SERVER WHERE VERSION = NOVELL NetWare 4.2 
[DS] 


If you don’t know the version number of a server, use the SHOW option. In this 
case, you can use NLIST SERVER SHOW VERSION. 


To list the network address of server ACCT (search all subordinate 
containers), type 


NLIST SERVER=ACCT SHOW NETWORK ADDRESS /S 

For bindery servers, type, 

NLIST SERVER=ACCT SHOW ATTACHMENT INFORMATION 
To list servers in the current context, type 

NLIST SERVER 

To search for servers in the Directory tree, type 

NLIST SERVER /S 

To see if server ACCT is up, type 

NLIST SERVER=ACCT /A 


To list servers whose name begins with L, type 
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Groups 


Printers 
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NLIST SERVER = L* 


To list members of group TEMPORARY, type 
NLIST GROUP=TEMPORARY SHOW MEMBERS 
To list groups with MSMITH as a member, type 
NLIST GROUP WHERE MEMBER EQ MSMITH 
To list the owner of group RECORDS, type 
NLIST GROUP=RECORDS SHOW OWNER 


To list all information about group RECORDS (bindery servers 
only), type 


NLIST GROUP=RECORDS SHOW MISC 


To list operators for printer P1, type 

NLIST PRINTER=Q1 SHOW OPERATOR 

To list users for printer P1, type 

NLIST PRINTER=Q1 SHOW USER 

To list printers whose name begins with P, type 
NLIST PRINTER WHERE NAME = P* 

To list printers in the current context and below, type 


NLIST PRINTER /S 


NLIST 





Print Queues (Bindery Servers) 


Volumes 


Objects 


@ To list operators for print queue Q1, type 


NLIST QUEUE=Q1 SHOW OPERATORS 
To list users for print queue Q1, type 
NLIST QUEUE=Q1 SHOW USERS 

To list print queue names, type 


NLIST QUEUE /N 


To list host servers where all volumes beginning with A reside, 


type 

NLIST VOLUME=A* SHOW HOST SERVER 

To list the bindery server where volume VOLI: resides, type 
NLIST VOLUME=VOL1 SHOW SERVER 


To list the server running Directory Services where volume VOL1 
resides, type 


NLIST VOLUME=VOL1 SHOW HOST SERVER 


To list objects named MYSERVER, type 
NLIST * WHERE NAME = MYSERVER 
To list objects in the current context, type 


NLIST * 
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Additional Information 





Topic See 
Current Context Context in Concepts. 
Properties Property in Concepts. 
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NLMLIB 





NLMLIB 


Purpose 


NLMLIB.NLM is a library of functions providing runtime support for POSIX 
and other NLM programs. You don’t need to load NLMLIB.NLM; it’s 
autoloaded by any module that needs it. 


See “CLIB” for more information. 
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NLS Manager 


Purpose 


Use at a Windows 3.1.x, Windows 95/98, or Windows NT workstation to 
manage NetWare Licensing Services (NLS). 


With NLS Manager, you can perform the following administrative tasks: 


+ 


+ 


+ 


+ 


Install a license certificate 

Create a metering certificate 

View licensing information on licensed products 
View license certificate details 

Assign users to license certificates 

View or change a license certificate’s owner 


View LSP (License Service Provider) Server information 


Figure 2-15 shows the browser in NetWare Administrator with NLS objects 
visible. 
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Figure 2-15 
NLS Objects in the NetWare Administrator 
Browser 
NetWare Administrator 
Object View Options Tools Window Help 
ACME_Inc 


& UNIX Service Handler 


H ServerA_SYS 
(B Novell+Net¥Yare 4+¥Version 410 

LÆ Tue Aug 22 11:16:43 1995-10700154 
Novell, Inc\.+GroupWise+4\.1 

LB Thu Jan 4 11:34:54 1996-167E 





In Figure 2-15 , notice that License Certificate objects are contained by 
Licensed Product container objects. For example, Novell+NetWare 4+ Version 
410 is the licensed product, and Tue Aug 22 11:16:43 1995-1070015A 
indicates the license certificate. 


Using NLS Manager 


See the online Help in NetWare Administrator for complete information on 
how to use the NLS Manager utility. 


Additional Information 





Topic See 





NetWare Licensing Services Managing NetWare Licensing 
Services in Supervising the Network . 
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NMENU 








Purpose 
Use at a workstation to access customized menus that have been created. 
Syntax 
NMENU menu_name_ [/?] 
Parameter Use to 
menu_name Specify the name of the .DAT menu file. 
/? View online help. All other parameters are 
ignored when /? is used. 
Using NMENU 


@ You can only use NMENU when a menu file already exists. 


@ You must know the name and location of the menu file and have 
Read and File Scan rights to the directory containing the menu file. 


Additional Information 








Topic See 
Creating menu files Creating a Menu File in Supervising the 
Network . 
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NPAMS 


Purpose 
Load on a NetWare 4 SFT III server to enable the mounting of a CD-ROM as 
a NetWare volume. 

Syntax 
LOAD NPAMS 

Using NPAMS 


@ NPAMS (NetWare Peripheral Architecture™ Mirrored Server) is 
a custom device module that is required for mounting a CD-ROM 
as a NetWare SFT HI volume. 


@ Load NPAMS in the MSEngine after loading the CD-ROM driver 


and the NetWare Peripheral Architecture driver (NPAIO.DSK) in 
the IOEngine. 


Additional Information 





Topic See 





Mounting a CD-ROM as an Mounting a CD-ROM as a NetWare 4 SFT Ill 
SFT III volume Volume in Supervising the Network . 
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NPATH 


Purpose 


Syntax 
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Use at a workstation to view the NetWare search sequence for a file. 


This information helps you troubleshoot why your station can’t find a particular 
file, why it’s finding an incorrect version of the file, or why it’s displaying a 
foreign language. 


NPATH [utility ][filename [,filename... ]] [/option 


ere | 
[/? | /VER] 


When you view your workstation’s search sequence for a file, include the name 
of the utility in the command. The search sequence depends on the drive and 
directory that the utility is executed from. 





Parameter Use to 

utility Specify the name of the utility you are trying to 
execute. 

filename Specify either the message or the Unicode* 


filename (and its extension) that your 
workstation either can’t find or can’t find the 
correct version of. 


/option Replace option with any available option. See 
“NPATH Options” 


/? View online help. All other parameters are 
ignored when /? is used. 


/VER View the version number of the utility and the 
files it uses to execute. All other parameters are 
ignored when /VER is used. 


NPATH 





Using NPATH 


Use NPATH when you try to execute a utility and have one of 
these problems: 


+ You get a message that you're missing a message file (either 
an .MSG, .HEP, .IDX, or .XLT file), or a Unicode file. This 
message identifies the file you're missing. 


+ You get a message that you have an incorrect version of a 
message file (an .MSG, .HEP, .IDX, or .XLT file). This 
message shows the version of the file your workstation 
found, and the version you need. 


+e You get a foreign language displayed on your screen. 


¢ Your workstation does not find a particular file in its search 
sequence. 


To find your workstation’s file search sequence for message files, 
use NPATH with no parameters. 


If you include a filename in the command, NPATH displays the 
path to the first occurrence of the file in the search sequence. 


To search for multiple files at the same time, separate the 
filenames with commas. 


A Unicode file without an extension defaults to the country code. 


Unicode files are not required to run NPATH. NPATH runs 
without a message file if the correct file is not available. 


The way the file search sequence is designed for NetWare utilities, 
the same path may be looked at more than once. 
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NPATH Options 





Option Use to 

(option name) 

A List the path to all occurrences of the file 
(All) you specify. 

D View the language, version number, 
(Details) date, and time of the file you specify. 
/Uni /D View the code page and country code 
(Unicode details) your workstation is set to, the Unicode 


files needed to run the NetWare utility, 
and the path to the first occurrence of 
each file. Does not require a filename. 


Uni List all paths to Unicode files. 
(Unicode) 


Troubleshooting with NPATH 





If Do the following 





You get a message that 
you’re missing a file but you 
know the file is located in a 
particular directory 


1. Map a search drive to the directory that the 
file is in. (To make the search drive permanent, 
add it to your login script.) 


2. Use NPATH if you want to confirm that your 
workstation can now find the file in its search 
sequence. 
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If Do the following 





You get a message that 
you’re missing a file and you 
don’t know where the file is 1. Check the PUBLIC/NLS\</anguage > 


located directory. 


2. If not in PUBLIC\NLS\</anguage> , use 
NDIR to locate the directory. 


3. If the file isn’t on any of your drives ( it’s not 
in PUBLIC\NLS\</anguage > and NDIR can’t 
find it), use NWXTRACT to get the file from 
diskette or CD. 


4. Map a search drive to the directory that the 
file is in. (To make the search drive permanent, 
add it to your login script.) 


5. Use NPATH to confirm that your workstation 
can now find the file in its search sequence. 


You get a message that you 


have the incorrect version of f 
a file 1. Use NPATH to view the search sequence 


your workstation is using to find each 
occurrence and version number of the file. 


2. Identify whether the version of the file you 
need is in the search sequence. Note: If your 
workstation finds an older version of a file 
before a newer version, it loads the older 
version. 


3. Run the utility from the directory that the 
version you need is in if that version is 
displayed in the search sequence, or copy the 
file to your current directory. 


4. Use NWXTRACT to get the file from diskette 
or CD if the version you need is not in the 
search sequence. 


5. Use NPATH if you want to confirm that your 
workstation can now find the correct version 
(before any other versions) in its search 
sequence. 
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Examples 
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If 





Do the following 





You get a foreign language 
displayed on your screen 


1. Change your NWLANGUAGE environment 
variable to your native language. 


2. Use the SET NWLANGUAGE= command in 
the AUTOEXEC.BAT file. 


3. Use NPATH to confirm that your workstation 
can now find your native language message 
files in its search sequence. 


To view your workstation’s search sequence for message files, 


type 


NPATH 


To view the path to the first occurrence of NCOPY.MSG found in 
the search sequence, type 


NPATH NCOPY NCOPY.MSG 


To view the path to each occurrence of FILER.MSG found in the 
search sequence, type 


NPATH FILER FILER.MSG /A 

To view the path to the first occurrence of SEND.HEP found in the 
search sequence, as well as its language, version number, date, 
and time, type 

NPATH SEND SEND.HEP /D 

To view the path to each occurrence of TEXTUTIL.MSG (for 
NETADMIN) found in the search sequence, as well as each file’s 


language, version number, date, and time, type 


NPATH NETADMIN TEXTUTIL.MSG /A /D 


NPATH 





To view your workstation’s search sequence for the Unicode files 
needed to execute FLAG, type 


NPATH FLAG /Uni 

To view which code page and country code your workstation is 
set to, the Unicode files needed to execute RIGHTS, and the path 
to the first occurrence of each Unicode file found in the search 
sequence, type 


NPATH RIGHTS /Uni /D 


To view the path to the first occurrence of UNI_LMON.001 found in 
the search sequence, type 


NPATH UNI_MON.001 /Uni 


To view the path to each occurrence of UNI_LMON.001 found in 
the search sequence, type 


NPATH UNI_MON.001 /Uni /A 
To view the code page and country code your workstation is set 
to, the Unicode files your workstation needs to run NetWare 


utilities, and the path to each occurrence of each file, type 


NPATH /Uni /D /A 


Additional Information 


Topic 


See 





Unicode files 


Search drive mappings 


NetWare utilities’ search 
sequence 


Unicode in Concepts . 


Drive mapping in Concepts . 


Search drive in Concepts . 


Search modes in Concepts . 
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NPRINT 


Purpose 
Use at a workstation to print plain text files or files from outside an application. 
Syntax 
NPRINT filename [P=printername | Q=queuename ] 
[/option ...] [/? | /VER] 


Additional Information 


Topic Refer to 





Using NPRINT Using NPRINT in Print Services . 
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NPRINTER.EXE 


Purpose 


Use at a Windows 3.1x workstation to attach a printer to the workstation. 


Syntax 
NPRINTER printername [/options ...] 
or 


NPRINTER printservername printernumber [/options 


-] 


Additional Information 


Topic See 





Using NPRINTER.EXE Setting Up Printers Attached to Workstations 
or Servers in Print Services . 
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NPRINTER.NLM 


Purpose 
Use to attach a printer to a NetWare server. 


Multiple NPRINTER.NLMs can be loaded on a NetWare server. 


Syntax 
LOAD NPRINTER printername 
or 


LOAD NPRINTER printservername printernumber 


Additional Information 


Topic See 





Using NPRINTER.NLM Setting Up Printers Attached to Workstations 
or Servers in Print Services . 
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NPRINTER (Windows 95/98) 


Purpose 


Use at a Windows 95/98 or Windows NT workstation to make a printer that is 
attached to the workstation available as a network printer. 


Using NPRINTER (Windows 95/98) 


After starting the Client 32 software, double-click NPTWIN95.EXE, which is 
usually located in the SYS:PUBLIC\WIN95 folder on your server. 


When the NetWare Nprinter Manager window opens, you can add a printer to 
the window either by completing the dialog box that displays initially, or by 
choosing the Printers menu, choosing Add, and then completing the dialog box. 


After the initial setup when you choose NPTWIN95.EXE, the program checks 
which printers need to be loaded on startup. If the print server is running and 


the printer specified is free, that printer is loaded and its icon is displayed in the 
Nprinter window. 


Additional Information 


Topic See 





Using NPRINTER (Windows 95/98) Setting Up Printers Attached to 
Workstations or Servers in Print 
Services . 
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NVER 


Purpose 


Use at a workstation to view version information for the workstation and 
attached servers 


Syntax 


NVER [/C] [/? | /VER] 





Parameter Use to 
/C Scroll continuously through information. 
/? View online help. All other parameters are 


ignored when /? is used. 


/VER View the version number of the utility and the 
files it uses to execute. All other parameters are 
ignored when /VER is used. 
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NWIPCFG 


Purpose 
Use at the server console to configure and manage the NetWare/IP™ server 
software. 
With NWIPCEG, you can perform the following tasks: 
@ Configure a NetWare server as a NetWare Domain Name System 
(DNS) client 
@ Configure the NetWare/IP server software 
@ Start the NetWare/IP service 
Syntax 


LOAD NWIPCFG 


Additional Information 


Topics 


See 





Installing the NetWare/IP software 


Using NWIPCFG 


Installing the NetWare/IP Software in 
NetWare/IP Administrator's Guide . 


Introducing UNICON and NWIPCFG 


and Configuring NetWare/IP Servers 
in NetWare/IP Administrator’s Guide . 


Chapter 2: Utilities 227 


NWXTRACT 





NWXTRACT 





Purpose 
Use at a workstation to extract and copy files from CD-ROM or from the 
installation diskettes to the network or to local drives. 
Syntax 
NWXTRACT path filename | groupname [destination ] 
[/option [/? | /VER] 
Parameter Use to 
path Specify the path to the master data file 
(FILES.DAT). 
Note: Master data files are language-specific 
and are located in their respective language 
subdirectories in the Directory tree. 
For example, the master data file for English 
(FILES.DAT) is located in the 
\NETWARE.40\ENGLISH directory. 
filename Specify the name of the file you want to extract. 
groupname Specify the name of the group of files you want 
to extract. A list of group names is available in 
online help. 
destination Specify the path where you want the extracted 
files copied to (if you don’t want them copied to 
the directories they were copied to at 
installation). 
/option Replace option with any available option. See 
“NWXTRACT Options” 
1? View online help. All other parameters are 
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ignored when /? is used. 


NWXTRACT 








Parameter Use to 





/VER View the version number of the utility and the 
files it uses to execute. All other parameters are 
ignored when /VER is used. 











NWXTRACT Options 
Option Use to 
S=server | server object Copy files to their normal location on the 
specified server. 
T=type Specify the type of file to be extracted. Types: 
DOS, SER (server), UNX, WIN. 
Examples 


@ = To extract FILER.EXE from the diskette and put it in the normal 
location on server ACCT, type 


NWXTRACT A:FILER.EXE /S=ACCT 


@ To extract NCOPY.MSG from the diskette and put it on drive C:, 
type 


NWXTRACT A:NCOPY.MSG C 
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OFF 


OFF 





Purpose 


Use at the server console to clear the console screen. (You can also use CLS to 
clear the screen.) 


Syntax 


OFF 
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PARTMGR 


Purpose 


Use at a workstation to manage partitions and their replicas. Figure 2-16 shows 
the functions available in PARTMGR. 


If you have a Windows 3.1x, Windows 95/98, or Windows NT workstation, you 
can use NDS Manager instead of PARTMGR to manage Novell® Directory 
Services (NDS) partitions and replicas. NDS Manager provides partitioning and 
replication services for the Directory database, as well as repair capabilities for 
repairing the database from a client workstation. 


NDS Manager provides server and workstation services at a single client 
location, which reduces the need for administrators of NDS to use RCONSOLE 
or to work directly with a server console. See “NDS Manager” 


Figure 2-16 
Functions in PARTMGR 


Allows you to: 











Partition administration 


Create partitions 

Merge partitions 

Add replicas 

Delete replicas 

Modify replica types 
Abort a partition operation 
Synchronize replicas 





Manage partitions 
Change context 





Allows you to set your current 
context 


Syntax 


PARTMGR [/VER] 





Parameter Use to 





/VER View the version number of the utility and the 
list of files it uses to execute. 
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For help with tasks, press <F1> in the utility. 


Using PARTMGR 


Using the PARTMGR Browser 


Figure 2-17 shows the PARTMGR browser that opens when you choose 
Manage Partitions from the Partition Administration menu. 


Figure 2-17 
The PARTMGR Browser 


Ob ject, Class 


(parent) 
P (current context) 
+DocTest (Organizational Unit) 
+TechPubs (Partition) 


This means that this 
container object is also 
the root of the partition. 








The + means that this object is a container. 


Press <F10> to create the container as a partition, or to go to 
the “Partition Management” menu if it is already a partition. 



















Choose this option to browse up the Directory tree to the 
parent container level. 





@ To browse up the Directory tree to the parent container, choose .. 
(parent). 
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Managing Replicas 


@ To view or edit the replicas of the current container object (if that 
container object is a partition), select . (current context) and press 
<F10>. 


@ To browse down the Directory tree, choose objects with a plus (+) 
in front of them. When you choose a container object, you can see 
the objects in that container. 


@ To create a new partition with a container object as the root of the 
partition, press <F10> on the container that you want to be the 
root of the partition. 


@ To view or modify a partition’s replicas, to merge a partition with 
its parent partition, or to abort a partition operation that’s in 
progress, select the partition and press <F10>. 


@ Objects that don’t have a plus (+) sign are servers. To see a list of 
the replicas stored on a server, select a server object and press 
<F10>. 


Replicas are copies of the information in the partition. They are stored on 
servers in the Directory tree. There are four types of replicas: master 

read/ write, read-only, and subordinate. For an explanation of replica types, see 
Replica in Concepts . 


Figure 2-18 shows the replica list, which includes the servers where the 
replicas are stored. 
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Figure 2-18 
Replicas Stored on a Server 











Lists the 
replica type. 


Lists the server object and its context, 
where the replica is stored. 





Ss 
| Replicas stored on server Type | 


TSHORTS . Servers .TechPubs .NPD .NOVELL Master 
TSTAR . Servers .TechPubs .NPD . NOVELL Read Write 








Examples 


Merge Partitions 
1. From the PARTMGR menu, select Manage Partitions and 
browse the Directory tree to select the partition you want to 
merge with its parent. 


2. Press <F10> and select Merge with Parent Partition. 


3. Press <F1> for help from here. 


Create Partitions 
1. From the PARTMGR menu, select Manage Partitions and 
browse the Directory tree to select the container you want to 
be the root object for the partition. 
2. Press <F10 >. 


3. Press <F1> for help from here. 
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View or Manage Replicas 
1. From the PARTMGR menu, select Manage Partitions and 
browse the Directory tree to select the partition whose 
replicas you want to manage. 
2. Press <F10> and select View/Edit Replicas. 


3. To manage replicas, press <F10>. 


4. Press <F1> for help from here. 


Additional Information 





Topic See 

Partitions Partition (Novell Directory) in Concepts . 
Replicas Replica in Concepts . 

Partition and replica Managing the Novell Directory Tree in 
operations Supervising the Network . 

NDS Manager “NDS Manager” 
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PCONSOLE 


Use at a workstation to 


Create, assign, modify, delete, and monitor print queues, print 
servers, and printers 


Send, monitor, modify, pause, resume, and delete print jobs 
Quickly install basic print services using Quick Setup 
Enable and view the print server auditing log 


Change your Novell Directory Services context 


PCONSOLE is the primary administrative utility for NetWare print services. 
NetWare Administrator provides functionality in the graphical environment 
similar to that provided by PCONSOLE in a menu environment. 


Purpose 
+ 
+ 
+ 
+ 
Syntax 


PCONSOLE 


Additional Information 





Topic See 
Using PCONSOLE Managing Print Services Using PCONSOLE in 
Print Services . 
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PING 


Purpose 


Syntax 


Using PING 


Use at the server console to send an Internet Control Message Protocol (ICMP) 
echo request packet to an IP node on your internetwork. 


PING determines whether an IP node is reachable on your internetwork. 


LOAD PING 


@ PING sends an ICMP echo request packet to an IP node on your 
internetwork. If the target node receives the packet, it sends back 
a reply packet. 


@  Toselect an IP node, enter its hostname or IP address in the Host 
Name field. 


You can also specify the number of seconds between each packet 
transmission and the size of the packet, in bytes. 


@ To start sending packets, press <Esc> . The sending node 
continues to send request packets and collect response time 
statistics until you press <Esc> again to exit PING. 


@ To select additional IP nodes, press <Ins> . Enter the hostname or 


IP address of the node in the Host Name field. Press <Esc> to start 
sending packets. 


Chapter 2: Utilities 237 


PRINTCON 


PRINTCON 





Purpose 
Use to create or modify print job configurations to specify a default printer and 
other options for users who use CAPTURE, NPRINT, NETUSER, or 
PCONSOLE. 
PRINTCON also allows you to change your current User or container object 
(in Novell Directory Services) or your NetWare server (in bindery mode). 
Syntax 


PRINTCON 


Additional Information 


Topic See 





Using PRINTCON Creating and Managing Print Job 
Configurations in Print Services . 
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PRINTDEF 


Purpose 


Use to view, modify, import, or export print device definitions and to monitor, 
modify, or create printer forms. 


Syntax 


PRINTDEF 


Additional Information 


Topic See 





Using PRINTDEF Working with Print Device Definitions and 
Printer Forms in Print Services . 
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PROTOCOL 


Purpose 
Use at the server console to 
@ View the protocols registered on your NetWare server 
@ Register additional protocols and frame types 
Syntax 


PROTOCOL [REGISTER protocol frame id# ] 





Parameter Use to 
(no parameter) Display the protocols registered on your server. 
REGISTER Register a protocol. 


It is only necessary to use PROTOCOL 
REGISTER in unusual cases, such as when 
using a new media. 


protocol Specify the protocol name. 

frame Specify the name representing the frame type 
that is to be bound to the communication 
protocol. 

id# Specify the protocol identification number (also 


called a protocol ID, PID, an Ethernet type or E- 
type, or an SAP). 


This number is a unique, assigned 
hexadecimal number that tells the server how 
to recognize data coming from a certain 
network board through a designated 
communication protocol (such as IPX). 
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Using PROTOCOL 


@ LAN drivers automatically register IPX; other protocol stacks 
register themselves. 


@ For approved protocol loadable modules, consult your reseller. 
For the protocol name, check the documentation that comes with 
the protocol module. 


@ LAN drivers automatically register a frame type when they are 
loaded. If the LAN driver supports more than one frame type, the 
frame type is registered when you load the driver with that frame 


type. 


Additional Information 





Topic See 





Binding protocols to a LAN Load the LAN Drivers in /nstallation and 
driver Upgrade 


“BIND” 
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PSC 





Purpose 


Use at a workstation to perform tasks that you might otherwise perform in 
PCONSOLE. Specifically, use PSC to 


@ View network printer information 
@ Control network printers 


@ Control the print server 


Syntax 


PSC ps=printserver p=printer [/option ...] [/? | / 
VER] 


Additional Information 


Topic Refer to 





Using PSC Using PSC in Print Services 
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PSERVER 


Purpose 
Use at the server console to monitor and manage printers and print queues. 
Multiple PSERVER modules cannot run concurrently on the same NetWare 
server. 

Syntax 


LOAD PSERVER .CN=printservername 
-OU=container .O=container 


Additional Information 








Topic Refer to 
Using PSERVER Setting Up and Servicing Print Servers in Print 
Services . 
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Purpose 
Use at the sever console to 
@ Upgrade your NetWare 3 print servers and printers to NetWare 4 
Directory Service objects 
@ Upgrade your NetWare 3 PRINTCON and PRINTDEF databases 
to NetWare 4 format 
Unless you run PUPGRADE, your NetWare 3 bindery print objects will not be 
upgraded. 
Syntax 


LOAD PUPGRADE 


Additional Information 





Topic Refer to 





Using PUPGRADE Using PUPGRADE.NLM in Print Services . 
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PURGE 


Purpose 
Use at the workstation to permanently remove previously deleted files from the 
file system. 
Syntax 
PURGE [filename | path ] [/option ...] [/? | /VER] 
Parameters 


Parameter Use to 





filename Replace filename with the names of the files 
you want to purge. Wildcards are allowed. 


path Replace path with the complete path of the 
directory containing the files you want to purge. 

/option Replace option with any available option. See 
“PURGE Options” 

/? View online help. All other parameters are 


ignored when /? is used. 


/VER View the version number of the utility and the 
list of files it uses to execute. All other 
parameters are ignored when /VER is used. 


Using PURGE 
@ You must have the Delete right to the specified directory. 


If you have the Delete right in the directory, and you don’t specify deleted files to 
be removed, all deleted files are removed, even if you don’t own them. 
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@ Ifyou have the Delete right at the root, you can use PURGE to 
remove all deleted files in the entire volume. 








PURGE Options 
Option Use to 
/A Purge all files in the current directory and its 
subdirectories. 
If you don’t use /A, PURGE removes only the files in the specified directory. 
Examples 


+ To purge all files in the current directory, type 
PURGE *.* 


@ To purge all .RPT files in the current directory and the 
subdirectories, type 


PURGE *.RPT /A 


@ Topurge all files starting at the root of the volume (you must have 
delete rights to the entire volume), type 


PURGE \*.* /A 


Additional Information 





Topic See 
Using FILER “FILER” 
Using RIGHTS “RIGHTS” 
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Topic See 





Salvaging deleted files Salvaging and Purging Deleted Files and 
Directories in Supervising the Network . 
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RCONSOLE 


Purpose 


Syntax 
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Use at a workstation to access the server by creating a remote server console. 


RCONSOLE will not allow remote access to a server if the network supervisor 
has not enabled remote connections using REMOTE. 


During a remote console session, you can load and unload modules, execute 
console commands, and copy files to NetWare directories or to non—NetWare 
partitions. You cannot transfer files from a server. 


RCONSOLE [server name ] | [server name* ] 





Parameter 


Use to 





(no parameter) 


server name 


Start a remote session either through a direct 
connection (SPX) or through an asynchronous 
connection (a modem). The system displays a 
menu from which you choose the connection 

type. 


Specify the name of the server or the IPX 
address you want to reach through a direct 
connection. 


Note: You can only specify the server name if 
you are establishing an SPX connection. You 
can't use this parameter when establishing an 
asynchronous connection. 





RCONSOLE 





Using RCONSOLE 





Parameter Use to 





server_name* Specify the partial name of the server you want 


to connect to via SPX. 


RCONSOLE then lists servers that begin with 
the specified sequence of letters. 


For example, to list servers that begin with 
SLS, type 


RCONSOLE SLS* 





You can access a remote server on the same network (a direct 
connection) or through a modem or null modem cable (an 
asynchronous connection). Instructions for establishing each kind 
of connection are found in Using Remote Console to Manage a 
Server in Supervising the Network . 


To access a server remotely, the necessary remote modules must be 
loaded on the server, the RCONSOLE.EXE file must be loaded on 
the workstation, and you must know the remote password. 


The remote modules that must be loaded on the server depend 
upon the way you are accessing the server: through a direct or an 
asynchronous connection. For more information, refer to Using 
Remote Console to Manage a Server in Supervising the Network . 


The supervisor password doesn’t allow remote access unless you 
set it as the password when you load REMOTE. 


You can execute RCONSOLE from your local hard drive or from a 
network drive. 


You don’t need Supervisor object rights to the remote server, since 
RCONSOLE doesn’t use Novell Directory Services. 


During a remote console session, you can press <Alt>+<F1> to 


display the RCONSOLE Available Options menu. This menu 
allows you to do the following: 
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+ Cycle through the screens being managed by the server 
e View lists of files and directories on the server 

e Transfer files to a server 

+ Display the operating system prompt 

@ Exit RCONSOLE 

+ Display the address of the workstation 

+ Buffer keystrokes sent to the server 


While the menu is displayed, press <F1> to display a help screen. 


@ You can use the following keystrokes during a remote console 
session. All other keys function as if you were at the server 
console. 





To Press 





Access the RCONSOLE Available <Alt>+<F1> 
Options menu 


Exit RCONSOLE <Alt>+<F2> 
Cycle through the console screens <Alt>+<F3> or <Alt>+<F4> 


Show the address of the workstation <Alt>+<F5> 
you are using 





Additional Information 








Topic See 

Using RCONSOLE Using Remote Console to Manage a Server in 
Supervising the Network . 

Using REMOTE “REMOTE” 
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REGISTER MEMORY 


Purpose 


Syntax 


Use at the server console to configure the operating system to recognize 
installed memory above the amount of memory that is automatically registered. 


NetWare 4 can address up to 3.25 gigabytes. This limitation is due to the size of 
the cache block tables used for memory management. 


REGISTER MEMORY start_address amount 





Parameter Use to 





start_address Specify the hexadecimal address where the 
memory you're adding will start. This is the 
amount of RAM your server currently 
recognizes and addresses. 


This number is usually 16 MB (1000000h); 
however, the default varies depending on the 
machine type. 


To obtain the start address, use the MEMORY 
command and convert its output to 
hexadecimal. 


amount Specify an amount of memory, expressed in 
hexadecimal, that is installed beyond the start 
address. This number must be divisible by 10h. 





In the preceding table and in the following sections, the h after the number 
denotes a hexadecimal number. The d denotes a decimal number. 


For example, 1000000h is 1 million in hexadecimal, and 1000000d is 1 million 
in decimal. 


The hexadecimal numbers A through F correspond to the decimal numbers 10 
through 15, respectively. 
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@ NetWare registers all memory that it recognizes according to bus 
type. On an ISA bus, NetWare recognizes up to 16 MB. On an EISA 
or MCA bus, NetWare recognizes all of the memory that is 
present. On a computer with a Peripheral Component 
Interconnect (PCI) bus, NetWare 4 recognizes up to 64 MB. 


@ To have the additional memory registered automatically when the 
server boots, add the REGISTER MEMORY line to the 
STARTUP.NCF file. 


Add this line just after the commands for the server name and 
internal network number, and before the volumes are mounted. 


Place the REGISTER MEMORY command before the MOUNT ALL command 
in the STARUTP.NCF file so that the registered memory will be available to all 
volumes. 


Failure to register memory before the SYS: volume is mounted can result in 
error messages indicating that the cache memory allocator is out of available 
memory, or that there is insufficient memory to mount volumes. 


+ Ifthe memory does not register, check for the following possible 
errors: 


+ An incorrect hexadecimal value was specified for start 
address or amount . 


+ Theamount value exceeds the total installed memory. Use 
the setup or reference diskette that came with the computer 
to determine the total amount of installed memory. 


If you have more than 16 MB of server memory installed, you must avoid 
memory address conflicts. A conflict occurs if an adapter board uses 16- or 24- 
bit DMA or Bus-Master DMA. 


To resolve this conflict, upgrade to 32-bit bus adapters or use drivers that are 
modified and certified to compensate for memory-addressing limitations. Or use 
the machine’s configuration program to move system memory around the 
adapter if the program allows. 


REGISTER MEMORY 





@ In some cases, the ISA (16-bit) host adapter driver must be loaded 
in memory below 16 MB. To do so, add the following to the 
STARTUP.NCF file: 


SET AUTO REGISTER MEMORY ABOVE 16 MEGABYTES=OFF 
LOAD disk_driver 
REGISTER MEMORY amount of memory to add 


For more information, consult the driver documentation. 


Determining the Amount of Memory 


The following table lists common start address and amount values for standard 


computers. 


In the table, total memory = start address + amount of memory to add. 


Total Memory 


Start Address 


Amount of Memory to Add 





20 MB 
24 MB 
28 MB 
32 MB 
36 MB 
40 MB 
64 MB 
112 MB 
128 MB 
256 MB 
400 MB 
1 GB (1000 MB) 


3 GB (3000 MB) 


16 MB = 1000000h 


16 MB = 1000000h 


16 MB = 1000000h 


16 MB = 1000000h 


16 MB = 1000000h 


16 MB = 1000000h 


16 MB = 1000000h 


16 MB = 1000000h 


16 MB = 1000000h 


16 MB = 1000000h 


16 MB = 1000000h 


16 MB = 1000000h 


16 MB = 1000000h 


4 MB = 400000h 


8 MB = 800000h 


12 MB = C00000h 


16 MB = 1000000h 


20 MB = 1400000h 


24 MB = 1800000h 


48 MB = 3000000h 


96 MB = 6000000h 


112 MB = 7000000h 


240 MB = F000000h 


384 MB = 18000000h 


984 MB = 3D80000h 


2984 MB = BA800000h 
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Total Memory Start Address Amount of Memory to Add 





3 GB (3000 MB) 64 MB = 4000000h 2936 MB = B7800000h 





REGISTER MEMORY requires that the amount of memory to be registered is 
stated in hexadecimal format. If you are adding an amount of memory that is 
not in the preceding table, then you need to calculate the amount. 


Calculating the Amount of Memory 


The following figure illustrates how to calculate the amount of memory you are 
adding: 


1 

Number of Number of 
bytes in = bytes in 
decimal hexadecimal 


MB memory 


to add 





1. Start with the amount of memory you are adding stated in 
decimal MB. 


Obtain this number from the documentation that came with the 
memory you are adding. 


2. Convert the memory value from MB to bytes. 


A megabyte of memory is more than a million bytes. One megabyte equals 
1,048,576 bytes in decimal. 


3. Convert the number of bytes from decimal to hexadecimal 
notation. 


To do this calculation, you can either use a calculator that converts 
decimal numbers to hexadecimal, or you can convert manually. 


For example, 1 megabyte = 1,048,576d, which is the same as 
100000h. 


So 1,048,576 bytes in decimal equals 100000 in hexadecimal. 


To convert manually, consult a specialized manual. 


REGISTER MEMORY 





Examples 
+ To add 4 MB of memory above 16 MB, type 
REGISTER MEMORY 1000000 400000 
+ To add 24 MB of memory above 16 MB, type 


REGISTER MEMORY 1000000 1800000 


Additional Information 








Topic See 
Editing the Modify the AUTOEXEC.NCF File in Installation 
AUTOEXEC.NCF file and Upgrade. 


Creating or Editing a Server Batch (.NCF) File 
in Supervising the Network . 


Displaying the total amount “MEMORY” 
of memory the server is 
addressing 
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REINITIALIZE SYSTEM 


Purpose 


Syntax 


Use at the server console to enable configuration changes made since the 
commands in the NETINFO.CFG file were executed. 


REINITIALIZE SYSTEM 


Using REINITIALIZE SYSTEM 


+ 


REINITIALIZE SYSTEM compares the current NETINFO.CFG 
file with the previous one, which became effective the last time 
you ran the INITIALIZE SYSTEM or REINITIALIZE SYSTEM 
command. If REINITIALIZE SYSTEM finds any new commands 
in the current NETINFO.CFG file, it executes them. 


REINITIALIZE SYSTEM also informs any Simple Network 
Management Protocol (GNMP)-registered NLM file that it is 
executing. This is a call-back mechanism that enables NLM files 
that store configuration information outside the NETINFO.CFG 
file to know that changes to the configuration have taken place. 


Limitations of REINITIALIZE SYSTEM 
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+ 


REINITIALIZE SYSTEM unloads any NLM affected by a 
configuration change. If REINITIALIZE SYSTEM cannot unload 
the NLM because of interdependencies with other modules, the 
configuration change will not take effect. Additionally, not all 
NLM files register with SNMP for notification of REINITIALIZE 
SYSTEM. 


When you create a new configuration or delete an existing 
configuration, REINITIALIZE SYSTEM recognizes the change. 
However, REINITIALIZE SYTEM may not recognize changes to 


REINITIALIZE SYSTEM 





an already configured NLM that involve more than loading, 
unloading, binding, or unbinding protocol stacks. 


If you are changing an existing configuration, the most effective way to ensure 
the changes are recognized is to down the server. Alternatively, if you know 
which NLM files have been changed by your modifications, you can unload 
them, then execute REINITIALIZE SYSTEM. 


Additional Information 





Topic See 
NETINFO.CFG file “INETCFG” 
INITIALIZE SYSTEM “INITIALIZE SYSTEM” 
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REMAPID 


Purpose 
Assists NETS YNC3 in handling password changes. 


REMAPID is autoloaded by NETS YNC3 on every NetWare 3.1x server in the 
NetSync cluster. 


REMAPID also handles password IDs that are changed by NetSync. It must 
remain loaded even after NETS YNC3 is unloaded so that users can continue to 


log in to the NetWare 3.1x server. 


The NetSync installation program adds the command to load REMAPID to the 
AUTOEXEC.NCF file on the 3.1x server. 


Syntax 


Autoloaded by NETS YNC3.NLM. 


Additional Information 


Topic See 





Installing REMAPID Installing and Using NetSync . 
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REMIRROR PARTITION 


Purpose 


Syntax 


Example 


Use at the server console to start the remirroring of a logical partition. 
Because the server remirrors partitions automatically, you should use 


REMIRROR PARTITION only if you have stopped remirroring or something 
has caused your server to cease remirroring. 


REMIRROR PARTITION number 





Parameter Use to 
number Specify the number of the logical partition you want to start 
remirroring. 





To start remirroring for logical partition 4, type 


REMIRROR PARTITION 4 


Additional Information 





Topic See 

Stopping remirroring “ABORT REMIRROR” 

Mirroring and unmirroring Mirroring and Duplexing a Hard Disk and 

hard disks Unmirroring Hard Disks in Supervising the 
Network . 
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REMOTE 


Purpose 


Syntax 
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Parameter 


Load at the server console to allow remote access to the server from a 
workstation. 


LOAD [path ] REMOTE password | -E Epassword 


Use to 





path 


password 


Epassword 


Specify the path to REMOTE.NLM if you moved it from 
the default directory. 


Specify the password you want administrators of the 
remote server to use. REMOTE requires either a 
password or an encrypted password. 


When you execute RCONSOLE, you use the password 
you established when you loaded REMOTE. 


Note: In NetWare 4, the supervisor password doesn’t 
allow remote access unless it is set as the password 
when you load REMOTE. 


If you specify this parameter, the password that follows 
must be an encrypted password. 


Note: You can’t use this parameter until you have first 
loaded REMOTE using the unencrypted password and 
then determined the encrypted value of the password by 
executing the REMOTE ENCRYPT command. Refer to 
the next section for more information about encrypting 

passwords. 


Specify the encrypted value of the password you want 
administrators of the remote server to use. 


To obtain the encrypted value of a password, use 
REMOTE ENCRYPT as described in the next section. 





REMOTE 





Using REMOTE 


Before RCONSOLE can be used to access a server from a 
workstation, you must load REMOTE on the server. When you 
load REMOTE, you establish a password that must also be entered 
when you execute RCONSOLE on the workstation. 


To optimize security, use an encrypted password when loading 
REMOTE. 


To encrypt the password, load REMOTE with the unencrypted 
password, then type: 


REMOTE ENCRYPT 


The system prompts you for a password to encrypt. Type the 
password and press <Enter> . 


The system displays the encrypted value and a message asking if 
the LOAD REMOTE command should be written to the 
SYS:SYSTEM\ LDREMOTE.NCF file. 


If you respond Yes, the system places a LOAD REMOTE 
command into the LDREMOTE.NCF file with the encrypted 
password as a parameter. You can execute this file to load the 
REMOTE module with the encrypted password 


After you load REMOTE, you must load other modules to make 
remote console sessions available. 


+ For direct connections, load the following: 


RSPX 


+ For asynchronous connections, load the following in the 
order shown: 


AIOCOMX (or other communication port driver) 
AIO 
RS232 


If you load AIOCOMxX, you do not need to load AIO, 
because it is autoloaded by AIOCOMX. However, if you 
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load another communication port driver, you may have to 
load AIO manually. 


@ To make RCONSOLE sessions available whenever you boot the 
server, enter the following commands in the AUTOEXEC.NCF file 
in the order shown. 


+ 


For direct connections: 
LDREMOTE 
LOAD RSPX 


For asynchronous connections: 

LDREMOTE 

LOAD AIOCOMX (or other communication port driver) 
LOAD AIO 

LOAD RS232 com_port baud_rate [N] [C] 


Include the N parameter if you are using a null modem 
cable. Include the C parameter if you are using a callback list. 
For more information about these parameters, see Running 
a Remote Console Session Over a Modem in Chapter 7 of 
Supervising the Network . 


If you load AIOCOMX, you do not need to include the 
command to load AIO. However, if you load another 
communication port driver, you may have to include the 
LOAD AIO command. 


@ Once you load REMOTE, you can use the REMOTE command to 
enable or disable remote connections. The syntax is 


REMOTE [parameter ] 


Parameter 


Use to 





LOCK OUT Prevent new remote connections. 


This parameter prevents new remote console 
sessions from being established with the 
server. 





REMOTE 





Examples 





Parameter Use to 





UNLOCK Allow new remote connections. 


This parameter is used to reenable remote 
sessions after the LOCK OUT parameter 
disabled them. 


HELP View online help. 





To load REMOTE with password SECRET, type 
LOAD REMOTE SECRET 

To obtain the encrypted value of a password, type 
REMOTE ENCRYPT 


To load REMOTE with an encrypted password, previously 
obtained by executing REMOTE ENCRYPT, type 


LOAD REMOTE -E 870B7E366363 

To disable new remote connections to the server, type 
REMOTE LOCK OUT 

To enable new connections to the server, type 

REMOTE UNLOCK 

To view help information for the REMOTE command, type 


REMOTE HELP 
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Additional Information 
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Topic See 
Loading RSPX “RSPX” 
Loading RS232 “RS232” 


Setting up a remote console 


Using RCONSOLE 


Editing the 
AUTOEXEC.NCF file 


Using Remote Console to Manage a Server 
Supervising the Network . 


“RCONSOLE” 


Modify the AUTOEXEC.NCF File in Installation 
and Upgrade. 


Creating or Editing a Server Batch (.NCF) File 
in Supervising the Network . 





REMOVE DOS 





REMOVE DOS 


Purpose 


Use at the server console to 


+ 


+ 


Remove DOS from the server’s memory 


Cause the server to be cold booted with the EXIT command 


A cold boot powers down the machine, clears memory and internal settings, and 
boots the machine. 


Syntax 


REMOVE DOS 


Using REMOVE DOS 


+ 


If available memory in the server is low, use this command to free 
additional memory for file caching. 


When you execute REMOVE DOS, the memory used for DOS is 
returned to the system for file caching. 


Removing DOS increases network security because loadable 
modules can’t be loaded from the server’s DOS drives. 


Once this command is issued, DOS is no longer resident in the 
server and NLM programs on DOS drives aren’t accessible. If you 
need to load these modules, copy them to a network drive before 
executing REMOVE DOS. 


If you remove DOS from the server, then when you use the EXIT 
command to exit the server console, you are not returned to DOS 
as you normally would be. Instead, the server reboots. This 
functionality of the REMOVE DOS command allows those using 
RCONSOLE to reboot the server remotely. 
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Additional Information 





Topic See 
Remote booting a server Rebooting a Remote Server in Supervising the 
Network . 
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RENDIR 


Purpose 


Use at a workstation to rename a directory. 


Syntax 


RENDIR path [TO] directory name [/? | /VER] 





Parameter Use to 

path Specify the path leading to and including the 
directory you want to rename. 

directory name Specify the new name of the directory. 

1? View online help. All other parameters are 


ignored when /? is used. 


/VER View the version number of the utility and the 
list of files it uses to execute. All other 
parameters are ignored when /VER is used. 





Using RENDIR 


@ Ifyourenamea directory, change any drive mappings that include 
the directory to reflect the new name. 


@ You can use a period to represent your default directory. 


@ You can use :/ to represent your current drive and volume. 


Examples 
@ To rename DOSAPPS (your current directory) to WINAPPS, type 


RENDIR DOSAPPS WINAPPS 
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To rename directory USE on drive Z: to USERS, type 
RENDIR Z:USE USERS 

To rename your current directory to PROGRAMS, type 
RENDIR . PROGRAMS 


To rename the directory where drive G: is mapped to 
PROGRAMS, type 


RENDIR G: PROGRAMS 


To rename directory TOOL to TOOLKIT on your current drive and 
volume, type 


RENDIR :/TOOL TOOLKIT 





Topic See 
Directory structure Directory structure in Concepts . 
Drive mappings Drive mapping in Concepts . 


MAP in Supervising the Network . 





REQUESTR 





REQUESTR 


Purpose 
REQUESTR.NLM is a library of functions that make up the standard NetWare 
Requester™ . You dont need to load REQUESTR.NLM; it’s autoloaded by any 


modules that need it. 


See “CLIB” for more information. 
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RESET ROUTER 


Purpose 


Use at the server console to reset the router table in the server if the table 
becomes inaccurate or corrupted. 


Syntax 


RESET ROUTER 


Using RESET ROUTER 


@ = Ifseveral servers or bridges go down, packets sent to or through 
their routers are lost. Use RESET ROUTER to update router tables 
on active servers. 


@ Normally, the router updates its tables every minute. This 
command updates the router table immediately. 
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RESTART 


Purpose 


Syntax 


Using RESTART 


Use at the server console to reload the IOEngine on one NetWare 4 SFT III 
server while leaving the other server running, or to force a server to switch over 
from primary to secondary. 


RESTART 


@ RESTART is valid only when servers are mirrored. 


@ Execute RESTART from the appropriate IOEngine. If you execute 
RESTART from an MSEngine, you receive an unknown command 
message. 


@ When the primary IOEngine is reloaded using RESTART, the 
secondary server takes over as the primary server. When the 
secondary IOEngine is restarted, the primary server remains 
running. 


Disks should be mirrored before you restart the primary |OEngine. If disks aren't 
mirrored when you execute RESTART, the following message appears: 


WARNING!!! Not every disk is remirrored. 

Answering yes may cause some volumes to dismount 

and open files to be lost. 

Are you sure you wish to halt then restart the 
primary server? 
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RESTART SERVER 


Purpose 


Use at the server console to restart the server after downing it. 


Syntax 


RESTART SERVER [-parameter ] 





Parameter Use to 
(no parameter) Restart the server and invoke all .NCF files. 
-nS Restart the server without invoking the 


STARTUP.NCF file. 
For example, type: 


RESTART SERVER -ns 


-na Restart the server without invoking the 
AUTOEXEC.NCF file. 


Using RESTART SERVER 


RESTART SERVER is useful when troubleshooting requires that you 
frequently down the server. 


Additional Information 


Topic See 





Restarting the server from “SERVER” 
DOS 
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RIGHTS 


Purpose 


Use at a workstation to 


@ View or modify user or group rights for files 


@ View or modify user or group rights for directories and volumes 


Syntax 


RIGHTS path 
[/? | /VER] 


Parameter 


IL + | - ] rights ] [/option ...] 


Use to 





path 


+|- 


rights 


/option 


/? 


/VER 


Specify the path to the file, directory, or volume 
you want to modify or view rights to (you must 
always specify a path). 


Add or delete the specified rights. See “Using 
RIGHTS” 


Specify one or more file or directory rights. See 
“File and Directory Rights” 


Replace option with any available option. See 
“RIGHTS Options” 


View online help. All other parameters are 
ignored when /? is used. 


View the version number of the utility and the 


list of files it uses to execute. All other 
parameters are ignored when /VER is used. 
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RIGHTS Options 


Option 


Use to 





/C 
/F 


/l 


/NAME=username 


IS 


/T 


Scroll continuously through output. 
View the Inherited Rights Filter (IRF). 


View the trustee and group rights that created 
the inherited rights, and view where the 
inherited rights came from. 


View or modify rights for the user or group 
listed. Replace username with the name of the 
user or group whose rights you want to view or 
modify. 


View or modify subdirectories below the 
current level. 


View trustee assignments in a directory. 





File and Directory Rights 


The following table lists the rights, the letter to use for each right, and what the 


right is used for. 


Right 


Use to 





S (Supervisor) 
R (Read) 

W (Write) 

C (Create) 

E (Erase) 


M (Modify) 


Grant all rights to the file or directory. 
Open and read files in the directory. 
Open and write to files in the directory. 
Create files and subdirectories. 

Erase files and directories. 


Rename files and directories, and change file 
attributes. 
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Using RIGHTS 


Examples 








Right Use to 

F (File Scan) View and search on file and directory names in 
the file system structure. 

A (Access Control) Add and remove trustees and change trustee 
rights to files and directories. 

N (No Rights) Remove all rights. 

REM (Remove) Remove the user or group as a trustee of the 
specified file or directory. 

ALL Add All rights except Supervisor. 

@ Ifyou use + (plus) to add rights, the rights you list are added to 


the existing rights. 


If you use - (minus) to remove rights, the rights you list are deleted 
from the existing rights. 


If you add and delete rights in the same command, group all 
added rights together and all deleted rights together. 


If you list rights without using + or -, the rights you list replace the 
existing rights. 


You must always specify a path. You can use a period (.) to 
represent your current directory. 


You can use wildcard characters. 


To set the trustee rights in the current directory for user JANICE 
to Read, Write, and File Scan, type 


RIGHTS . R W F /NAME=JANICE 
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@ To remove user JACIE from ALICE/SYS:USERS, type 
RIGHTS ALICE/SYS:USERS REM /NAME=JACIE 


@ To see where user PAT’s inherited rights came from for 
SYS:USERS/HOME, type 


RIGHTS SYS:USERS/HOME /NAME=PAT /I 


Additional Information 





Topic See 
Trustee assignments Trustee in Concepts . 
Inherited rights Security in Concepts . 
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ROUTE 


Purpose 


Syntax 


Use at the server console on a token ring cabling system to pass frames 
(packets) from NetWare through IBM-compatible source route bridges. 


ROUTE enables the operating system to 
@ = Keep track of the source routing information in the frames 


@ Configure the source routing information in the frames according 
to the parameters with which ROUTE is loaded 


You must load the token ring LAN driver before you load ROUTE. 


ROUTE and most ROUTE parameters can also be configured using the 
INETCFG utility. See the section below, “Configuring Source Route End 
Station Parameters with INETCFG.” 


LOAD [path ]ROUTE [BOARD=number ] [NAME=board_name ] 
[DEF |GBR|MBR] [TIME=number ] [RSP=AR|NR] [CLEAR] | 
[REMOVE=number ] [XTX=number ] [UNLOAD 
[BOARD=number ]] 





Parameter Use to 





path Specify the path to ROUTE.NLM if you moved it 
from the default directory. 
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Parameter 





Use to 





BOARD=number 


NAME =board_name 


DEF (Default) 


GBR (General Broadcast 
frames) 


Specify the board you want to change parameters 
on or load ROUTE for. Replace number with the 
board number. 


If you don’t specify a board number, the default is 
board number 1, or the board name specified in 
the NAME parameter. 


The system numbers the boards, using 1 for the 
first driver loaded. (Check the order in the 
AUTOEXEC.NCF file.) 


Specify the board name. 


Specify that all Unknown Unicast frames are to be 
sent as All Routes Broadcast frames. 


If DEF is specified, all frames with addresses not 
inthe server’s Source Routing table are forwarded 
as All Routes Broadcast frames. 


If DEF is not specified, all frames with addresses 
not in the server’s Source Routing table are 
forwarded as Single Route Broadcast frames. 


If ROUTE is already loaded with the DEF 
parameter, reloading ROUTE with DEF sends all 
Unknown Unicast frames as All Routes Broadcast 
frames. 


Specify that all General Broadcast frames are to 
be sent as All Routes Broadcast frames. 


If this parameter is not specified when ROUTE is 
loaded, all General Broadcast frames are 
broadcast as Single Route Broadcast frames. 


If ROUTE is already loaded with the GBR 
parameter, reloading ROUTE with GBR 
broadcasts all General Broadcast frames as All 
Routes Broadcast frames. 





ROUTE 





Parameter 





Use to 





MBR (Multicast 
Broadcast frames) 


TIME=number 


RSP=value (Respond) 


Specify that all Multicast frames are to be sent as 
All Routes Broadcast frames. 


If the parameter is not specified when ROUTE is 
loaded, all Multicast frames are broadcast as 
Single Route Broadcast frames. 


If ROUTE is already loaded with the MBR 
parameter, reloading ROUTE with MBR 
broadcasts all Multicast frames as All Routes 
Broadcast frames. 


Specify how often the Source Routing table 
should be updated. 


Replace number with a value from 3 to 255 
seconds. The default is 10 seconds. 


This parameter forces the table to be updated with 
a new route if the route isn’t used during the 
specified time. 


It enables ROUTE to determine alternate routes 
dynamically when an IBM bridge goes down. 


Specify how the server should respond to a 
broadcast request. 


Replace value with one of the following: 


NR: Specifies that all Broadcast Requests are to 
be responded to directly; a Broadcast Response 
isn’t required. 


AR (the default): Specifies that all Broadcast 
Requests are to be responded to with an All 
Routes Broadcast frame. 
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Parameter 





Use to 





CLEAR 


REMOVE=number 


XTX=number 


Clear the Source Routing table. Use when an IBM 
bridge has gone down and an alternate route is 
available. 


CLEAR forces a dynamic rebuilding of the table by 
sending a default frame to each specific node in 
the network. 


Use CLEAR to completely clear the Source 
Routing table, or use REMOVE to clear only one 
node address from the Source Routing table. 


Remove a specified node address from the 
server's Source Routing table. 


Replace number with a 12-digit (6-byte) 
hexadecimal number. 


If you enter fewer than nine digits, ROUTE 
prefixes the address with 4000 in hexadecimal. 


For example, REMOVE=2 becomes 
REMOVE=400000000002. 


Use REMOVE when a bridge has gone down. 
When you remove the node from the Source 
Routing table, you force the server to determine 
an alternate route. 


Specify the number of times to transmit on a 
timed-out route, using the old route. 


Replace number with a value between 00 and 
255 seconds. The default is 02 times. 


ROUTE 





Using ROUTE 








Parameter Use to 
UNLOAD Use to remove source routing support for a 
[BOARD=number ] specified board. 


If you don’t specify a board number, the default is 
1. 


Example: 
LOAD ROUTE UNLOAD BOARD=2 


Note: This parameter does not unload 
ROUTE.NLM, but disables source routing only for 
the board that you specify. 





No parameters are required. However, you can load ROUTE a 
second time with a specified parameter to change the 
configuration. 


Most of the parameters have default values that should work with 
simple configurations for IBM bridges. 


If you have parallel IBM bridges, you can change some of the 
parameters to reduce traffic on some of the paths. 


As frames pass through an IBM bridge, source routing 
information is added to the frame header at the Media Access 
Control (MAC) layer. The operating system’s bridging is done 
above this layer. 


ROUTE can be loaded re-entrantly. 


+ If you have two token ring boards in the server, load ROUTE 
twice. The second time you load it, use the BOARD or 
NAME parameter to specify a particular board. 


+ To change the configuration, load ROUTE with the 
parameter that needs to be changed. 
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Configuring Source Route End Station Parameters with INETCFG 
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You can use INETCFG to load ROUTE and configure many source route end 
station parameters. 


To use INETCFG, follow these steps. 


1. 


2. 


Load INETCFG. 


From the Internetwork Configuration menu, choose the 
Boards option to load a token ring board. 


Return to the Internetwork Configuration menu and use the 
Protocols option to enable Source Route End Station. 


Return to the Internetwork Configuration menu and select 
Bindings. 


A list of bindings appears. 


Select an existing binding or press <Insert> to add a new 
binding. 


A list of enabled protocols appears. 


Select Source Route End Station. 


A list of boards is displayed. 


Select the token ring board you configured with the Boards 
option. 


The Attach Source Route End Station to an Interface menu 
appears. 


The following Source Route End Station parameters are available: 


ROUTE 





Table 2-5Source Route End Station Parameters 


Parameter 


Use to 





Interface Name 

(same as 

NAME =board_name 
command line parameter) 


Frame Type 


Send Frames with Unknown 
Address 

(same as DEF [Default] 
command line parameter) 


Send Broadcast Frames 
(same as GBR command 
line parameter) 


Send Multicast Frames 
(same as MBR command 
line parameter) 


Respond to Broadcast 
Request 

(same as RSP command 
line parameter) 


Route Update Interval 
(same as TIME=number 
command line parameter) 


View the name of the interface to which the end station source router is 
bound. This field is read-only. 


View or modify the source route end station list of frame types. 


Press <Enter> to see the list. Press <Insert> to select a frame type. Press 
<Delete> to remove a frame type. 


Specify the type of explorer frame the end station source router sends to 
an unknown node address. 


Options: Single Route Explorer Frame, All Routes Explorer Frame 


Default: Single Route Explorer Frame 


Specify the type of explorer frame the end station source router sends to a 
broadcast destination address. 


Options: Single Route Explorer Frame, All Routes Explorer Frame 


Default: Single Route Explorer Frame 


Specify the type of explorer frame the end station source router sends to a 
multicast, group, or functional address. 


Options: Single Route Explorer Frame, All Routes Explorer Frame 
Default: Single Route Explorer Frame 


Specify how the end station source router responds to a single route 
explorer frame. 


Options: Specifically Routed Frame, All Routes Explorer Frame 


Default: All Routes Explorer Frame 


Specify the minimum delay in seconds before the end station source router 
updates the route for a given node. 


Range: 0 to 65,535 seconds (0=infinite) 
Default: 10 
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To remove source route bridge support for the specified board, disable the 
binding. 


Additional Information 








Topic See 

INETCFG “INETCFG” 

Source routing Source routing in Concepts 

Source routing and IBM Token-Ring Network Architecture 
broadcast frames Reference 
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RPL 








Purpose 
Use at the server console to enable the remote booting of diskless workstations 
that have network boards installed. 
Syntax 
LOAD [path ]RPL 
Parameter Use to 
path Specify the path to RPL.NLM if you moved it 
from the default directory. 
Using RPL 


@ The RPL.NLM program is used in networks that have diskless 
workstations installed with the RPL BIOS module. RPL.NLM 
provides the Remote Program Load protocol stack to the server. 


@ After loading the RPL protocol stack, you must bind RPL to the 
network board in the server. 


Additional Information 


Topic See 





Using RPL to setup Remote The Novell Client documentation. 
DOS workstations 
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Purpose 
Use at the server console to set up a communication port for remote 
management over a modem or null modem cable. 
The RS232 module is an asynchronous communications driver that initiates the 
server’s communication port and transfers screen and keystroke information to 
and from REMOTE. 
Syntax 
LOAD [path ]RS232 [COM port ] [modem speed ] [N] [C] 
Parameter Use to 
path Specify the path to RS232.NLM if you moved it 
from the default directory. 
COM port Specify the communication port (1 or 2). 
If you don’t specify a COM port with the LOAD 
command, you are prompted for it. 
modem speed Specify the baud rate of your modem (2400, 
4800, or 9600). If you don’t enter the modem 
speed with the LOAD command, you are 
prompted for it. 
N Specify that a null modem cable will be used. 
C Enable callback functions. 
Using RS232 


You must load a communication port driver (such as AIOCOMX) and AIO before 
you load RS232. (If you load AIOCOMX first, it autoloads AIO. If you use a third- 
party communication port driver, you may need to load AIO manually.) 
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After RS232 is loaded, you can execute the following commands while in the 


utility: 


Command 


Use to 





RS232 
MODEM 


MODEM @filename 


View RS232 driver settings. 
Interact with the modem. 


Retrieve modem commands from a file. 


MODEM modem_command Send commands directly to the modem. 





Additional Information 





Topic 


See 





Using RS232 


Using Remote Console to Manage a Server in 
Supervising the Network . 
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RSPX 





Purpose 
Use at the server console to allow RCONSOLE to access a server over a direct 
connection. RSPX loads the SPX driver for REMOTE and advertises the server 
to workstations. 
RSPX provides an optional security feature requiring that all RSPX packets 
contain signatures. 
RSPX packet signatures are not related to NCP packet signatures. To modify 
RSPX packet signature requirements, use RSPX. To modify NCP packet 
signature requirements, use SERVMAN or SET. See “SERVMAN” or “SET” 
Syntax 
LOAD [path ]RSPX [SIGNATURES OFF] 
Parameter Use to 
path Specify the path to RSPX.NLM if you moved it 
from the default directory. 
SIGNATURES OFF Allow remote console RSPX packets without 
signatures. 
The default is packet signatures ON. 
Note: If you use a NetWare 3.11 of 
RCONSOLE to access a NetWare 4 server, 
turn packet signatures off when you load 
RSPX. 
Using RSPX 


After RSPX is loaded, the following commands are valid: 


RSPX [parameter ] 
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Parameter 


Use to 





(no parameter) 


SIGNATURES ON 


SIGNATURES OFF 


HELP 


Additional Information 


View RSPX status information. 


Require all RCONSOLE client RSPX packets 
to contain signatures. 


Allow RCONSOLE client packets without 
signatures. 


Note: If you use a NetWare 3.11 version of 
RCONSOLE to access a NetWare 4 server, 
turn packet signatures off when you load RSPX 
on the server. 


View online help. 





Topic 


See 





Using RSPX 


Using Remote Console to Manage a Server in 
Supervising the Network . 
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SBACKUP 


Purpose 


Use at the server console to back up and restore specified data on a server, 
workstation, or service that you select. 


Syntax 


LOAD [path ]SBACKUP SIZE=xx BUFFER=x 


Parameter Use to 





path Specify the path to SBACKUP.NLM if you 
moved it from the default directory. 


SIZE=xx Specify the size of the buffer (in KB). 
Supported values: 16, 32, 64, 128, or 256. 
Default: 64 KB. 

BUFFER =x Specify the number of buffers. 


Supported values: 2 to 10. 











Default: 4. 
Additional Information 
Topic See 
Using SBACKUP Backing Up and Restoring Data in Supervising 
the Network . 
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SCAN FOR NEW DEVICES 


Purpose 


Use at the server console to register new devices with the media manager so 
they are available to the operating system. 


Syntax 


SCAN FOR NEW DEVICES 


Using SCAN FOR NEW DEVICES 


+ 


Use this utility if you add new devices after you boot your server 
and the devices do not then appear with the LIST DEVICES 
command. 


If devices have been added, but the drivers aren’t loaded in 
STARTUP.NCE, use SCAN FOR NEW DEVICES after loading the 
drivers to register the devices with the system. 


If NetWare detects new devices since you booted the server, SCAN 
FOR NEW DEVICES registers the devices with the operating 
system. It does not return a message to the screen. 


SCAN FOR NEW DEVICES does not produce any output. 


If you remove a hot-plug mirrored disk without bringing down 
the server, you must execute SCAN FOR NEW DEVICES as soon 
as you remove the disk. This lets the system know that the 
remaining disk in the mirrored pair is no longer synchronized 
with a mirrored partner. If you unmirror the disk before removing 
it, you do not need to run SCAN FOR NEW DEVICES. 
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Purpose 
Use at the server console to 
@ Prioritize server processes 
@ Schedule processes to use less of the server’s CPU 
@ Slow processes when the server is very busy 
Syntax 
LOAD SCHDELAY [process_name = number ...] 
Parameter Use to 
(no parameter) View a list of all valid process names and their 


current SCHDELAY values. If the list scrolls off 
the screen, you may choose to view the list in 
the Scheduling Information option in 
MONITOR. 


process_name Specify a process that will use the scheduling 
delay. Valid processes are those that access 
the server’s CPU. 


number Specify the frequency at which the process 
should run. Valid values are 0 (run every cycle) 
and from 2 to 10000. For example, 2 means 
run every second cycle. 





You can undo SCHDELAY values for all processes by replacing process_name 
with ALL PROCESSES and replacing number with 0 . This causes all 
processes to run with no delays. The command syntax is 


LOAD SCHDELAY ALL PROCESSES = 0 
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Using SCHDELAY 
The SCHDELAY value affects processes only when the system is busy. 
@ You can specify multiple process delays at one time. 
+ To slow specific processes and use less of the server’s CPU each 
time the server boots, place a SCHDELAY command in your 


AUTOEXEC.NCF file. 


@ You can also view scheduling delays with the Scheduling 
Information option in MONITOR. 


Example 
To schedule the Remirror process to skip every other cycle, type 


LOAD SCHDELAY REMIRROR PROCESS = 2 


Additional Information 








Topic See 

Determining which Prioritizing Server Processes in Supervising 
processes are hoarding the Network . 

CPU time or which 

SCHDELAY value to assign 

to a process 

Editing the Modify the AUTOEXEC.NCF File in 
AUTOEXEC.NCF file Installation and Upgrade. 


Creating or Editing a Server Batch (.NCF) File 
in Supervising the Network . 
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Purpose 
Use at the server console to 
@ Tell the server where to look for loadable module files and .NCF 
files 
@ Add other search paths or delete current search paths 
@ View the current search paths for the operating system 
Syntax 


SEARCH [ADD [number ] path ] 
or 


SEARCH DEL [number ] 





Parameter Use to 
(no parameter) View the current search paths. 
number Specify the number of the search drive you 


want to add or remove. 


path Specify the complete path of the directory you 
want searched. (The default is SYS:SYSTEM.) 


Begin the path with a DOS drive letter or a 
NetWare volume name. 





Using SEARCH 


@ To set search paths each time the server comes up, place the 
SEARCH commands in the AUTOEXEC.NCF file. 
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@ = Ifyou execute SECURE CONSOLE, SEARCH is disabled. The 
SYS:SYSTEM search path remains in effect, but you cannot create 
new search paths. 


Once you execute SECURE CONSOLE, you must bring down the 
server and reboot it to create additional search paths. 


When the server comes up and the SYS: volume is mounted, the search path 
to the boot partition is deleted. 


Example 
@ To display the current server search paths, type 
SEARCH 
@ To add VOL1:NCF (a network directory) as a search path, type 


SEARCH ADD VOL1:NCF 


Additional Information 








Topic See 
Adding a search path Viewing and Adding Server Search Paths in 
Supervising the Network . 
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SECURE CONSOLE 


Purpose 
Use at the server console to increase network security by 
@ Preventing loadable modules from being loaded from any 
directory other than SYS:SYSTEM 
@ Preventing keyboard entry into the operating system debugger 
@ Preventing the server date and time from being changed 
Syntax 


SECURE CONSOLE 


Using SECURE CONSOLE 


@ When you execute SECURE CONSOLE, path specifiers are 
disabled. The SYS:SYSTEM search path remains in effect, but you 
cannot create new search paths. 


@ Use of SECURE CONSOLE is recommended, especially in 
security-sensitive environments. SECURE CONSOLE prevents 
the following types of breaches in security: 


+ Trojan Horse Modules. If you don’t use SECURE CONSOLE, 
a module can be loaded from a DOS partition, a diskette 
drive, or any directory on a NetWare volume. 


If you allow modules to be loaded from all these drives, 
anyone who has access to the server console can load a 
loadable module. An intruder could create a module to 
access or alter any information on the server, or to change 
user account information at the server security level. 


+ Date and Time Modifications. Some security and accounting 
features (such as password expiration, time restrictions, 
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intruder detection, and lockout intervals) depend on date 
and time for their enforcement. 


If you don’t use SECURE CONSOLE, an intruder can change 
the date and time at the server and bypass these time- 
dependent features. 


@ To disable SECURE CONSOLE, down the server properly, and 
then reboot the server. 


Additional Information 


Topic See 





Additional security tips Server console in Concepts . 
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SEND 


Purpose 
Use at a workstation or the server console to 
@ Send messages to users attached to the server 


@ Seta workstation to receive all messages, only system messages, 
or no messages 


@ View the current broadcast mode at the client 
@ Poll for messages 


@ Send a message to all users logged in or attached to the NetWare 
server, or to a list of users or connection numbers 


The console command SEND has the same functionality as the BROADCAST 
command from previous versions of NetWare. The BROADCAST command is 
also available in NetWare 4. 


You can also use MONITOR.NLM to send messages to workstations. See 
Sending a Message Using MONITOR in Supervising the Network . 


Syntax 


At the Server Console 


SEND message [[TO] username | connection number ] 
[[AND|],] username |connection number ] 


Unlike the client SEND command, groupname is not a valid parameter at the 
server. 
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Parameter 


Use to 





message 


username 


connection number 


Specify the message (up to 55 characters) you 
want to send. 


Note: Quotation marks around the message 
are not required if you send the message to all 
users. 


Specify the users you want to send the 
message to. 


To send to all users, don’t include any 
usernames or connection numbers. 


Separate users with a comma, a space, or and 


Depending on the connection type, you need to 
specify either the user’s complete name (for 
example, BOB.SALES.NOVELL), or the user’s 
name (For example, BOB). 


Use the user name as it appears in Connection 
Information in MONITOR. 


Specify the number of the station you want to 
send the message to. 


Separate connection numbers with acomma, a 
space, or and. 


To determine the connection number, find the 
corresponding connection number next to the 
user’s name in Connection Information in 
MONITOR. 





At a Workstation 


Workstations on NDS Servers (NetWare 4) 


SEND [message 


[username | groupname | 


servername ]] [/options ...] [/? | /VER] 
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Parameter Use to 





message Specify the message you want to send. 


username , groupname , or Specify the recipient of the message. 











servername ; ; 
Separate multiple names with a comma, a 
space, or and. 
/option Replace option with any available option. See 
“SEND Options” 
1? View online help. All other parameters are 
ignored when /? is used. 
SEND Options 
Option Use to 
/A=A or /A Accept all messages. 
/A=C Accept messages only from the server 
console. 
/A=N Accept no messages. 
/A=P Stores the last message sent until you poll to 
receive it. 
/P Poll the server for the last stored message. 
IS Show the current broadcast mode. 
/B Send across a bindery connection when 


logged in to NDS. 





Workstations on Bindery Servers (NetWare 2 and 3) 
SEND message [TO] [servername / [username | 


groupname | station number ]] 
[servername / [/option ...]] [/? | /VER] 
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Using SEND 





Parameter Use to 
message Specify the message you want to send. 
servername Specify the server the user is logged in to. If no 


username or groupname 


station number 


/option 


/? 


/VER 


server is specified, the message is sent to the 
server your current drive is mapped to. 


Specify the recipient of the message. 


Separate multiple names with a comma, a 
space, or and. 


Specify a workstation connection number. 
Separate multiple numbers with a comma, a 
space, or and. 


Specify any available option. See “Options for 
Workstations on Bindery Servers.” 


View online help. 


View the version number of the utility and the 
list of files it uses to execute. 


Options for Workstations on Bindery Servers 








Option Use this option to 

EVERYONE Sends message to members of the group 
EVERYONE. 

CONSOLE Sends message to the server console. 

/B Allows bindery syntax from an NDS 


connection. 


@ All users except the following receive messages: 
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+ Those who used SEND at the workstation with the Accept 
None option. 


+ Those logged in using ACS or NACS. 
+ Those logged in on remote workstations. 
+ Those using some graphics applications. 


+ Those who are attached to the server but not logged in. 
@ Messages don’t interfere with a workstation’s display; however, 


the user can’t make entries on the screen until messages are 
cleared. 


Examples 


Workstation Examples 


+ — To send the message Time for the meeting to Bob, Sue, and Jeff, 


type 
SEND TIME FOR THE MEETING BOB, SUE, JEFF 


+  Tosend the message Time for the meeting to Bob, using a 
complete name, type 


SEND TIME FOR THE MEETING .BOB.NOVELL 


+ To send the message Time for the meeting to KELLEY on bindery 
server FRIENDLY (if you are logged in to NDS), type 


SEND TIME FOR THE MEETING FRIENDLY/KELLEY /B 


(If you are not logged in to NDS, you don’t need to use /B.) 


+ To set your workstation to receive only console or system 
messages, type 


SEND /A=C 


@ To clear a message from a workstation and resume work, type 
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Server Examples 


Additional Information 


<Ctrl>+<Enter> 


To send the message The server is going down to all users logged 
in or attached to the server, type 


SEND THE SERVER IS GOING DOWN 
To send The server is going down to user ANDREA, type 
SEND THE SERVER IS GOING DOWN ANDREA 


To send Log out please to user ANDREA, using the complete 
name, type 


SEND LOG OUT PLEASE ANDREA.SALES .NOVELL 


To send Paychecks are here! to connection 1 (from a bindery 
connection), type 


Paychecks are here! 1 


To send Meeting time to users ANDREA, BRYAN, and MICHAEL 
and to stations 1 and 4, type 


SEND MEETING TIME TO ANDREA, BRYAN, MICHAEL, 1, 4 


Topic See 





Using SEND to send a Sending Console Messages to Workstations 
message fromthe console in Supervising the Network . 


Bindery-based server Bindery in Concepts . 


Stopping message displays Sending Console Messages to Workstations 


in Supervising the Network . 
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Topic See 





Using MONITOR.NLM to Sending a Message Using MONITOR in 
send a message to a Supervising the Network . 
workstation 
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SERVER 


Purpose 
Use at the server console from the DOS prompt to 
@ Boot NetWare on your server 
@ Execute the STARTUP.NCF file 
@ Mount volume SYS: 
@ Execute the AUTOEXEC.NCF file 
@ Execute the INITSYS.NCF file 
Syntax 


SERVER [parameter ] 


Parameter Use to 





-s [path ]filename .NCF Specify an alternative to STARTUP.NCF. 
Replace filename with the name of the 
alternate file. (The file extension must be .NCF) 


The system looks for the file in the current boot 
directory, unless you specify a path. 


-na Prevent the AUTOEXEC.NCF file that you 
created in INSTALL from executing. 


This parameter is useful if you are changing 


drivers or other commands in your 
AUTOEXEC.NCF file. 
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Parameter Use to 





-ns Prevent the STARTUP.NCF and 
AUTOEXEC.NCF files created in INSTALL 
from executing. 


This parameter is useful for changing the boot 
process. 


Using SERVER 


@ SERVER is a DOS-executable file that boots the NetWare operating 
system. 


@ If neither of the .NCF files exists, SERVER prompts you for a 
server name and an IPX internal network number; SERVER then 
brings up the console prompt (:). 


@ To automatically bring up the server when you boot up the 
machine, you can do one of the following: 


+ Place the SERVER command in the AUTOEXEC.BAT file in 
your boot partition. 


+ Use REMOVE DOS to boot the NetWare operating system 
automatically after you down the server and use the EXIT 
command. 


@ SERVER executes STARTUP.NCF and AUTOEXEC.NCE, if they 
exist. 


Additional Information 





Topic See 





Restarting server execution “RESTART SERVER” 
from the console prompt 


Editing NCF files Creating or Editing a Server Batch (.NCF) File 
in Supervising the Network . 
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SERVMAN 


Purpose 


Syntax 


Using SERVMAN 


Use at the server console to 
@ View and configure system parameters 


@ Change system parameter values in the AUTOEXEC.NCF, 
STARTUP.NCF, and TIMESYNC.CFG files 


@ View volume, storage, network, adapter, device, and disk 
partition information 


SERVMAN has the same functionality as the SET command. 


LOAD SERVMAN 


The SERVMAN (Server Manager) main screen displays statistics about the 
server, such as processor use, processor speed, and number of modules loaded. 
See Figure 2-19 . 


The main screen also displays an Available Options menu. These options give 
you access to more detailed information. 


Earlier versions of SERVMAN allowed you to configure IPX/SPX. 
Configuration of IPX/SPX is now done through the INETCFG utility. See 
“INETCFG” 


For more information, press <F1> while you are in the utility. 
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Figure 2-19 
The SERVMAN Main Screen 





Server Manager 4.10 


Server General Information 


NetWare Loadable Module 


Server uptime: 
Processor utilization: 
Processor speed: 
Server processes: 
Loaded NLMs: 

Mounted volumes: 
Active queues: 
Logged-in users: 
Loaded name spaces: 


3:01:19:49 


Available Options 


Server parameters 

Storage information 
Volume information 
Network information 








Enter=Select option Tab=Next window Alt+F10=Exit Fi=Hel 





Statistics Displayed on the SERVMAN Main Screen 


The SERVMAN utility updates statistics every second. 





Statistic 


Explanation 





Server uptime 


Processor utilization 


Processor speed 


Server processes 


Loaded NLMs 
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Length of time the server has been running 
since it was last booted. 


Percentage of time that the server CPU is busy. 
Speed at which the processor is running, 
based on CPU clock speed, CPU type, and the 
number of memory wait states. 


Number of processes running on the server. 


Number of modules loaded on the server. 


SERVMAN 








Statistic 


Explanation 





Mounted volumes 
Active queues 


Logged-in users 


Loaded name spaces 


Number of volumes mounted on the server. 
Number of active queues on the server. 
Number of users logged in to the server. 


Number of name spaces loaded on the server. 


Selections in the SERVMAN Available Options Menu 


Menu Option 


Use to 





Server parameters 


Storage information 


Volume information 


Network information 


Additional Information 


Topic 


e View and configure operating system 
parameters. 


+ Change system parameter values in the 
AUTOEXEC.NCF and STARTUP.NCF files. 


View adapter, device, and partition information. 


View information about volumes mounted on 
the server. 


View network information, such as number of 
packets received and transmitted. 


See 





SET command 


“SET” 
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SET 


Purpose 
Use at the server console to view and configure operating system parameters. 
You can also use SERVMAN or MONITOR to configure and set operating 
system parameters. 
The default SET parameters give maximum performance for most systems. 
Network supervisors should seldom need to change parameters. 

Syntax 
SET [parameter ] = [value ] 

Parameters: 


“Communication Parameters” 
“Memory Parameters” 

“File Caching Parameters” 
“Directory Caching Parameters” 
“File System Parameters” 

“Lock Parameters” 

“Transaction Tracking Parameters” 
“Disk Parameters” 

“Time Synchronization Parameters” 
“NCP Parameters” 

“Miscellaneous Parameters” 

“Error Handling Parameters” 
“Novell Directory Services Parameters” 
“SFT III Parameters” 
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Using SET 


Although most parameters don’t need to be changed, you might increase the 
performance of your system by changing some parameters. Suggestions for 
improving server performance can be found in Monitoring and Optimizing the 
Server in Supervising the Network . 


Displaying and Changing Current Settings 


Entering Parameters 


+ 


If you type SET without a parameter, a list of categories appears. 
When you select a category, the current settings for the parameters 
in that category appear, along with the setting limits and a brief 
description of each parameter. 


If you type SET with a parameter but no value, the current setting, 
setting limits, and a brief description of the parameter appear. 


If you type SET with a parameter and a value, the operating 
system is reconfigured according to the specified value. 


You can also use the SERVMAN NLM to display and modify 
parameter settings. See “SERVER” 


You can use most SET parameters at the console prompt. The 
system is immediately configured to that setting. Any setting in 
the AUTOEXEC.NCF file is overridden until the server is 
rebooted. 


You can save SET commands you execute at the console prompt in 
the AUTOEXEC.NCF file. When a parameter is saved, the server 
configures itself to the parameter each time the server is booted. 


If the parameter isn't saved in the file, the system returns to the 
default setting for the parameter when the server is booted. Some 
commands can be saved in the STARTUP.NCF file. 


Edit the AUTOEXEC.NCF or the STARTUP.NCF file with 
INSTALL. If you use SERVMAN to change SET parameters, you 
are prompted to update .NCF files before exiting the utility. 
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Parameters that Control the Allocation of Services 


Some SET parameters control how the system dynamically allocates services. 
Three types of parameters interact to control the allocation of a service: 


+ 


Maximum limits control how many resources the operating 
system can allocate for a particular service. 


Minimum limits allow the operating system to allocate a 
minimum number of resources as soon as a request is received. 


Low minimum limits slow the growth of a particular service. High 
minimum limits allow rapid growth. 


For example, if the minimum number of directory cache buffers is 
set to 20, the system allocates another buffer resource as soon as a 
request is made until 20 cache buffers have been allocated. 


When 20 directory cache buffers are allocated, the system waits 2.2 
seconds (default) when a request comes in, and then allocates 
another buffer if the request is still active. 


However, if the minimum number of directory cache buffers is set 
to 40, the system allocates 40 directory cache buffers before it starts 
slowing the growth by waiting 2.2 seconds after each request. 


Wait time limits control how rapidly the operating system can 
allocate a new resource. 


Communication Parameters 
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Communication parameters control settings for communication buffers. Four 
parameters configure packet receive buffers; four control the watchdog. 


+ 


Packet Receive Buffers are areas in the server’s memory that are 
set aside to hold data packets. The packets remain in the buffers 
while the server processes them. 


To view the number of packet receive buffers allocated, use 
MONITOR. 


SET 





@ Watchdog Packets make sure stations are connected. If the server 
doesn’t receive a packet from a station within a set time (Delay 
Before First Watchdog Packet), a watchdog packet is sent to the 
station. 


@ Ifthe station doesn’t respond within a set time (Delay Between 
Watchdog Packets), another packet is sent. If the station doesn’t 
respond to a set number of packets, the server assumes that the 


station is no longer connected and clears the station’s connection. 


See Table 2-6 for a description of communication parameters. 
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Table 2-6Communication Parameters 





Parameter 


Use to 





Maximum Packet Receive Buffers = 
number 
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Specify the maximum number of packet receive buffers the 
operating system can allocate. 


Supported values: 50 to 25000. 
Default: 100. 


Note: For SFT Ill systems, the default is 400. 


Before increasing this parameter, use MONITOR to view the 
server's use of packet receive buffers and service processes. 


If the number of packet receive buffers is at maximum, increase 
this parameter in increments of 10 until you have one packet 
receive buffer per workstation. 


If you have EISA or microchannel bus master boards in your 
server, increase this parameter to provide at least five buffers per 
board. 


If the board is producing No ECB available count errors, provide 
10 buffers per board. Use MONITOR (LAN Information) to 
determine if the board is producing errors. 


If the number of allocated service processes is at maximum, you 
can increase the Maximum Service Processes parameter to 
decrease the need for more packet receive buffers. 


The value of this parameter should be greater than the value of 
the Minimum Packet Receive Buffers parameter. If it is less, the 
system increases the value to match that of the Minimum Packet 
Receive Buffers parameter. 


This parameter can be set in the appropriate startup .NCF file. 


SET 





Parameter 





Use to 





Minimum Packet Receive Buffers = 
number 


Maximum Physical Receive Packet 
Size = number 


Specify the minimum number of packet receive buffers the 
operating system can allocate. The operating system allocates 
this number of buffers as soon as the server boots. You must add 
this command to the STARTUP.NCF file. You cannot change the 
setting at the console prompt. 


Supported values: 10 to 20000. 
Default: 50. 


Note: For SFT Ill systems, the default is 100. This parameter 
must be set to the same value in the MSSTART.NCF and 
IOSTART.NCF files. 


Before increasing this parameter, use MONITOR to view the 
server's use of packet receive buffers. 


If you have EISA or microchannel bus master boards in your 
server and are receiving No ECB available count errors (see LAN 
Information in “MONITOR” on page 142 ) right after the server 
boots, increase this parameter so that each board can have at 
least five packet receive buffers. 


If the allocated number is higher than 10 and the server doesn't 
respond immediately after booting, increase this parameter. 


In NetWare 4.2, the value of this parameter must be less than the 
value of the Maximum Packet Receive Buffers parameter. If it is 
greater, the system increases the value of the Maximum Packet 
Receive Buffers parameter to match that of the Minimum Packet 
Receive Buffers parameter. 


Specify the maximum size of packets that can be transmitted on 
the network. You must add this command to the STARTUP.NCF 
file. You cannot change the setting at the console prompt. 


Supported values: 618 to 24682. 
Default: 4202. 


The default allows 2 KB (data with the packet header). If you use 
token ring or Ethernet boards, the default is acceptable. 


If some of your network boards transmit more than 512 bytes of 
data per packet, set this parameter for the largest packet size. 
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Parameter 


Use to 





IPX NetBIOS Replication Option = 
number 


Maximum Interrupt Events = number 


Reply to Get Nearest Server = value 


Number of Watchdog Packets = 
number 


Delay Between Watchdog Packets = 
time 
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Specify how the IPX router handles replicated NetBIOS 
broadcasts. 


Supported values: 


0 = Do not replicate NetBIOS broadcasts. 
1 = Duplicate broadcasts when there are redundant routes. 
2 = Suppress duplicate broadcasts. 


Default: 2. 


Specify the maximum number of interrupt time events (such as 
IPX routing) allowed before a thread switch is guaranteed to have 
occurred. 


Supported values: 1 to 1000000. 
Default: 10. 


Specify whether the server responds to Get Nearest Server 
requests from stations trying to locate directory and file servers. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Supported values: ON, OFF. 
Default: ON. 


Specify the number of unanswered watchdog packets that the 
server sends to a workstation before closing its connection. 


Supported values: 5 to 100. 
Default: 10. 


Specify the amount of time between watchdog packets. 


Supported values: 9.9 seconds to 10 minutes 26.2 seconds. 
Default: 59.3 seconds. 


After a server sends out the first watchdog packet, it waits the 
specified time before sending out succeeding packets if it 
receives no reply. 


SET 








Parameter 


Use to 





Delay Before First Watchdog Packet = 
time 


New Packet Receive Buffer Wait Time 


= time 


Console Display Watchdog Logouts = 
value 


Specify the amount of time the server waits without receiving a 
request from a workstation before sending out the first watchdog 
packet to that station. 


Supported values: 15.7 seconds to 14 days. 
Default: 4 minutes 56.6 seconds. 


Specify how long the operating system waits after receiving a 
request for a packet receive buffer before granting a new buffer. 


Supported values: 0.1 second to 20 seconds. 
Default: 0.1 second. 


This parameter prevents the system from granting too many 
buffers during a sudden peak in usage. 


If you have an EISA bus master board in your server, don’t change 
this parameter. 


Specify whether a console message is displayed when a 
connection is cleared. 


Supported values: ON, OFF. 
Default: OFF. 


If your network is running smoothly, you don’t need to display 
watchdog logouts. 


If your workstations are having connection problems, the 
watchdog logout messages can help you isolate which stations 
aren't receiving or sending watchdog packets. 





Memory Parameters 


Memory parameters control the size of the dynamic memory pool and the 
automatic registering of memory on EISA bus computers. 


For a description of memory parameters, see Table 2-7 . 
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Table 2-7Memory Parameters 


Parameter 


Use to 





Allow Invalid Pointers = value 


Read Fault Notification = value 


Read Fault Emulation = value 


Write Fault Notification = value 


Write Fault Emulation = value 
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Specify whether invalid pointers are allowed to cause a 
nonexistent page to be mapped in with only one notification. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Supported values: ON, OFF. 
Default: OFF. 


Specify whether the console and error log are notified of emulated 
read page faults. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Supported values: ON, OFF. 
Default: ON. 


Specify whether a read that occurs from a nonpresent page is 
emulated. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Supported values: ON, OFF. 
Default: OFF. 


Specify whether the console and error log are notified of emulated 
write page faults. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Supported values: ON, OFF. 
Default: ON. 


Specify whether a write that occurs from a nonpresent page is 
emulated. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Supported values: ON, OFF. 
Default: OFF. 


SET 








Parameter Use to 





Garbage Collection Interval = number Specify the maximum time between garbage collections. 
This parameter can be set in the STARTUP.NCF file, if desired. 


Supported values: 1 minute to 1 hour. 
Default: 15 minutes. 


Number of Frees for Garbage Specify the minimum number of times memory must be freed 
Collection = number before a garbage collection can occur. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Supported values: 100 to 100000. 
Default: 5000. 


Minimum Free Memory for Garbage Specify the minimum free allocation bytes needed for garbage 
Collection = number collection. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Supported values: 1000 to 1000000. 
Default: 8000. 


Alloc Memory Check Flag = value Specify whether the server will do corruption checking in the alloc 
memory nodes. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Supported values: ON, OFF. 
Default: OFF. 
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Parameter 


Use to 





Auto Register Memory Above 16 
Megabytes = value 


Reserved Buffers Below 16 Meg = 
number 


File Caching Parameters 


Control the automatic registering of memory above 16 MB in 
EISA computers. 


Supported values: ON, OFF. 
Default: ON. 


You must set this parameter in the STARTUP.NCF file. You cannot 
set the value at the command line. 


Use OFF if you have installed a network board or a disk adapter 
board that uses an online DMA or AT bus. (The board can 
address only 16 MB of memory correctly.) 


If you install one of these boards and the server addresses more 
than 16 MB of memory, the board corrupts server memory 
because it addresses low memory instead of its assigned high 
memory and corrupts the low memory in use. 


Use ON if you want memory above 16 MB to be registered with 
the operating system. 


Specify the number of file cache buffers reserved for device 
drivers that can’t access memory above 16 MB. 


Supported values: 8 to 300. 
Default: 16. 


You must set this parameter in the STARTUP.NCF file. You cannot 
set the value at the command line. 


File caching allows faster access to frequently used files by holding a file (or a 
portion of it) in memory. Files being read from or written to are kept in file 
cache buffers. 


The number of files kept in memory depends on the number of file cache 
buffers allowed. This is determined by the amount of memory available and the 
Minimum File Cache Buffers parameter. 


See Table 2-8 for a description of file caching parameters. 
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Table 2-8File Caching Parameters 


Parameter 


Use to 





Read Ahead Enabled = value 


Read Ahead LRU Sitting Time 


Threshold = number 


Minimum File Cache Buffers = 
number 


Specify whether the system conducts background reads to cache 
in advance of blocks soon to be requested. 


Supported values: ON, OFF. 
Default: ON 


Read-aheads can happen only when sequential file accesses are 
occurring. 


Specify the minimum cache LRU (least recently used) sitting time 
for read-aheads to take place. 


Supported values: 0 seconds to 1 hour. 
Default: 10 seconds. 


Set the minimum number of cache buffers the operating system 
can allow for file caching. 


Supported values: 20 to 1000. 
Default: 20. 


All memory not allocated for other processes is given to file 
caching. As memory is requested for other processes, the server 
gives up cache buffers. 


This limit specifies when the server must stop giving file cache 
buffers to other processes. 


If you set the minimum too high, other processes may not be able 
to allocate necessary memory resources. 


For example, a module could fail to load because the server is out 
of available memory. 
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Parameter 


Use to 





Maximum Concurrent Disk Cache 
Writes = number 


Dirty Disk Cache Delay Time = time 


Minimum File Cache Report 
Threshold = number 
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Specify the number of write requests for changed file data that 
can be put in the elevator before the disk head begins a sweep 
across the disk. 


Supported values: 10 to 4000. 
Default: 50. 


A high number creates more efficient write requests. A low 
number creates more efficient read requests. 


Monitor the number of dirty cache buffers on the information 
screen in MONITOR. 


If this number is above 70% of total cache buffers, optimize the 
write speed by increasing this parameter. 


Specify how long the system keeps a write request (that does not 
fill a cache buffer) in memory before writing the request to disk. 


Supported values: 0.1 second to 10 seconds. 
Default: 3.3 seconds. 


Increasing the time makes disk writing more efficient if your users 
make many small write requests. 


Decreasing the time can reduce performance drastically, and 
reduces the chances of losing data only slightly. 


Specify how few cache buffers can be available before the 
operating system warns you that the number of buffers is getting 
low. 


Supported values: 0 to 1000. 
Default: 20 


For example, if the Minimum File Cache Buffers parameter is set 
to 20 and this parameter is set to 25, you are warned when all but 
45 cache buffers are allocated for other processes. 


Regardless of how this parameter is set, the operating system 
warns you when it reaches the minimum number of cache buffers. 
You receive the following message: Cache memory allocator 
exceeded minimum cache buffer left limit. 


SET 





Directory Caching Parameters 
Directory caching allows fast access to frequently used directories. A directory 
cache buffer is a portion of NetWare server memory that holds entries from the 
directory table. 
A directory entry stays in a cache buffer as long as it is accessed frequently 
(default: 33 seconds). The system can overwrite the directory entry if the 


allocated directory cache buffers are accessed more frequently. 


See Table 2-9 for a description of directory caching parameters. 


Allocation of Directory Cache Buffers 
When the server boots, the system allocates a minimum number of directory 
cache buffers (default: 20). It creates these buffers immediately when it 


receives a request for a new buffer. 


When the minimum number of buffers is allocated and another is needed, the 
system must wait a specified amount of time before allocating another buffer. 


If necessary, the system allocates buffers until it reaches the maximum. If 


enough directory cache buffers are allocated and enough memory is available 
for directory caching, all directory tables can be cached in memory. 


How Directory Caching and File Caching Work Together 


As directory cache buffers increase, file cache buffers decrease. Thus, a 
tradeoff exists between directory caching and file caching. 


Directory caching and file caching must be balanced carefully for maximum 
performance. 


If you adjust the system to use too much memory for directory caching, you can 
leave too little memory for file caching, and vice versa. 
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Table 2-9Directory Caching Parameters 


Parameter 


Use to 





Dirty Directory Cache Delay Time = 
time 


Maximum Concurrent Directory 
Cache Writes = number 


Directory Cache Allocation Wait Time 
= number 
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Specify how long the system keeps a directory table write request 
in memory before writing it to disk. 


Supported values: 0 to 10 seconds. 
Default: 0.5 second 


Increasing the delay time gives slightly quicker performance but 
increases the probability of the directory tables becoming 
corrupted. 


Decreasing the delay time slightly reduces the chance of 
directory tables becoming corrupted, but can reduce performance 
slightly. 


A zero setting reduces performance dramatically. 


Specify how many write requests from directory cache buffers are 
putin the elevator before the disk head begins a sweep across the 
disk. 


Supported values: 5 to 50. 
Default: 10. 


A high number creates more efficient write requests. A low 
number creates more efficient read requests. 


Specify how long the system must wait after allocating a new 
directory cache buffer before it can allocate another buffer. 


Supported values: 0.5 second to 2 minutes. 
Default: 2.2 seconds. 


During this time, all requests for a new directory cache buffer are 
ignored. 


If the wait time is too low, peak usage requests cause more 
resources than necessary to be allocated to directory caching. 


If the wait time is too high, the system is very slow in allocating the 
directory cache buffers necessary to service the usual number of 
directory requests. 


If directory searches seem slow even after the server has been 
running for 15 minutes, you may want to decrease this parameter. 


SET 





Parameter 





Use to 





Directory Cache Buffer 
NonReferenced Delay = time 


Maximum Directory Cache Buffers = 
number 


Specify how long a directory entry must be cached before it can 
be overwritten by another directory entry. 


Supported values: 1 second to 5 minutes. 
Default: 5.5 seconds. 


Increasing this parameter speeds directory access. The system 
allocates more directory cache buffers, and a directory is more 
likely to be cached in memory. 


Decreasing this parameter slows directory access but also 
reduces the need for directory cache buffers. 


Specify the maximum number of cache buffers that the system 
can allocate for directory caching. 


Supported values: 20 to 4000. 
Default: 500. 


This parameter keeps the system from allocating too many 
directory cache buffers so that memory is available for other 
server processes. 


Increase this limit if the server responds slowly to directory 
searches. 


Decrease this limit if too much memory is being allocated for 
directory caching. 


If users are warned that the server is low on memory, this 
parameter should be one of the first to be reduced. (Reboot the 
server to return the memory to the cache buffer memory pool.) 


When a directory cache buffer is allocated, the allocation is 
permanent until the server reboots; the buffers don’t return to file 
caching when the need for directory cache buffers decreases. 


This parameter can be set in the STARTUP.NCF file, if desired. 
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Parameter 


Use to 





Minimum Directory Cache Buffers = 
number 


Maximum Number of Internal 
Directory Handles = number 
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Specify the minimum number of cache buffers that the system 
can allocate for directory caching. 


Supported values: 10 to 2000. 
Default: 20. 


The number needs to be high enough that directory searches can 
be done quickly, but no higher than necessary. 


If the system doesn’t need the minimum number of directory 
cache buffers, the buffers can’t be reallocated to file caching. The 
unneeded portion remains unused. 


If the server responds slowly to directory searches after it is 
booted, monitor the number of directory cache buffers usually 
allocated for directory caching. 


If the number is significantly higher than this limit, consider 
increasing the limit to remove the delay time that normally occurs 
while the server is self-configuring. Use MONITOR to view the 
current statistics. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Specify the maximum number of directory handles available for 
internal NLMs that use connection 0. 


Supported values: 40 to 1000. 
Default: 100. 


A directory handle is a version of the directory access rights that 
is held in cache memory. Caching the access rights speeds 
mapping to the rights. 


Connection 0 is the connection number reserved for use by the 
server itself and by NLMs operating within the server. 


Each time an NLM program using connection zero accesses a file 
or directory, a directory handle is allocated (up to the total 
specified by this parameter). This value represents the total 
number of handles available to be shared by all NLMs using 
connection 0. 


SET 








Parameter 


Use to 





Maximum Number of Directory 
Handles = number 


File System Parameters 


Specify the maximum number of directory handles available for 
each connection. 


Supported values: 20 to 1000. 
Default: 20. 


A directory handle is a version of the directory access rights that 
is held in cache memory. Caching the access rights speeds 
mapping to the rights. 


Each time a connection accesses a file or directory, a directory 
handle is allocated (up to the total specified by this parameter). 


@ Three parameters control warnings about volumes that are almost 


full. 


@ Four parameters control file purging. File-purging parameters 
influence other parameters, which in turn control warnings about 
almost-full volumes. 


All deleted files remain on the disk for a specified minimum 
amount of time. The system calculates a volume’s remaining space 
by subtracting the following from the total space: 


+ 


+ 


Actual files 


Salvageable files that can’t be purged because their 
Minimum File Delete Wait Times have not expired 


@ One parameter controls the reuse of turbo FATs. 


@ Eight parameters control file compression. 


See Table 2-10 for a description of file system parameters. 
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Table 2-10File System Parameters 


Parameter 


Use to 





Minimum File Delete Wait Time = time 


File Delete Wait Time = time 


Allow Deletion of Active Directories = 
value 





328 Utilities Reference 


Specify how long a deleted file remains salvageable on the 
volume. 


Supported values: 0 seconds to 7 days. 
Default: 1 minute 5.9 seconds. 


Files deleted for less than this minimum aren’t automatically 
purged even if the volume is full and users can’t create new files. 


Specify when a salvageable file can be purged to create free 
space on a volume. 


Supported values: 0 seconds to 7 days. 
Default: 5 minutes 29.6 seconds. 


Set this parameter as high as is useful for your users, but this 
parameter doesn’t guarantee that a file remains salvageable. 


The system tries to keep at least 1/32 of available space on the 
volume free for new files. 


This parameter only guarantees that files aren’t purged to 
maintain this free disk space. 


Files that haven't met this time limit are purged if the volume is full 
and the system needs space for a user to create a new file. 


When a deleted file remains on the server longer than the File 
Delete Wait Time parameter setting, the system marks the file as 
purgeable. 


When the volume is full of purgeable files and needs free space, 
the oldest purgeable files are purged. 


Specify whether a directory can be deleted when another 
connection has a drive mapped to it. 


Supported values: ON, OFF. 
Default: ON. 


SET 





Parameter 





Use to 





Maximum Percent of Volume Space 
Allowed for Extended Attributes = 
percentage 


Maximum Extended Attributes per 
File or Path = number 


Fast Volume Mounts 


Maximum Percent of Volume Used by 
Directory = percentage 


Immediate Purge of Deleted Files = 
value 


Limit the portion of volume space used for extended attribute 
storage. The setting takes effect only when the volume is being 
mounted. 


Supported values: 5 to 50. 
Default: 10. 


Limit the number of extended attributes that can be assigned toa 
file or path (subdirectory). This limit applies to all volumes on the 
server. 


Supported values: 4 to 512. 
Default: 16. 


Increase the speed at which volumes are mounted. 


Supported values: ON, OFF 
Default: ON. 


The operating system checks o only the most important fields 
during the mounting process. Use this parameter only if volumes 
were dismounted normally. 


This parameter can be set in the STARTUP.NCF file. 


Limit the portion of a volume that can be used as directory space. 


Supported values: 5 to 85. 
Default: 13. 


Controls whether deleted files can be salvaged. If this parameter 
is set to OFF, files can be salvaged with the FILER utility. See 
“FILER” 


Supported values: ON, OFF. 
Default: OFF. 


If this parameter is set to ON, all files are purged immediately 
when they are deleted. 
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Parameter 


Use to 





Maximum Subdirectory Tree Depth = 
number 


Volume Low Warn All Users = value 
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Specify how many levels of subdirectories the system supports. 


Supported values: 10 to 100. 
Default: 25. 


You must set this parameter in the STARTUP.NCF file. You cannot 
set the parameter at the command line. 


Increase the number if your applications support trees deeper 
than 25. 


Decrease the number if your applications support only shallow 
tree structures. 


(Some DOS applications can’t support more than 10 levels if the 
subdirectories have 11-character names.) 


Have the system notify users when a volume is almost full. 


Supported values: ON, OFF. 
Default: ON. 


If you choose not to have your server warn users, monitor volume 
statistics at least daily with SERVMAN or MONITOR. 


SET 





Parameter 





Use to 





Volume Low Warning Reset 
Threshold = number 


Volume Low Warning Threshold = 
number 


Control how much disk space must be freed up before a second 
warning is issued that the volume is almost full. (The first warning 
is controlled by the Volume Low Warn All Users parameter.) 


Supported values: 0 to 100000 blocks. 
Default: 256 blocks. 


When a volume is almost full, it can hover at its warning threshold 
as users create and delete files. 


This parameter controls the minimum amount of space that must 
be made available above the threshold before the warning 
message disappears. 


Example: Assume the volume block size is 4 KB, the Volume Low 
Warning Reset Threshold is set to 256, the Volume Low Warning 
Threshold is set to 256, and the volume has less than 1 MB of free 
space. 


Given these conditions, the volume must gain at least 1 MB of free 
space (for a total of 2 MB of free space) and then dip below 1 MB 
before the system sends another warning that the volume is 
almost full. 


Specify the number of blocks of free disk space that can remain 
on a volume before the system issues a warning. 


Supported values: 0 to 1000000 blocks. 
Default: 256 blocks. 


Consider the following: A block is the minimum space allocated to 
a file; a file can grow only in multiples of the block size. 


The block’s physical size is determined when the volume is 
created. A volume can be assigned these block sizes: 4 KB, 8 KB, 
16 KB, 32 KB, or 64 KB. 


For example, if you enter 256 blocks for this parameter and the 
volume’s block size is 4 KB, the system warns you that the volume 
is full when about 1 MB of space is left. 


If your volumes are assigned different block sizes, each volume 
has a different amount of free space when the warning is issued. 
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Parameter 


Use to 





Turbo FAT Re-Use Wait Time = time 


Compression Daily Check Stop Hour 
= number 
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Specify how long a turbo FAT buffer remains in memory after an 
indexed file is closed. 


Supported values: 0.3 second to 1 hour 5 minutes 54.6 
seconds. 
Default: 5 minutes 29.6 seconds. 


Once the wait-time value has passed, the system can allocate the 
buffer to another indexed file. 


Increase the wait time if 


+ You want the turbo FAT index to remain in memory for long 
periods of time, even when the file is closed. 


+ You frequently reopen the same file after a specific delay and 
know that another file opened during that delay will reuse the 
index. 


Decrease the wait time if you want the memory released 
immediately to service the next file that needs to be indexed. 


When a program randomly accesses a file that contains more 
than 64 FAT entries, the system builds a turbo FAT index for the 
file so that information is accessed quickly. (The NetWare 3 
system indexes any randomly accessed file with 64 entries in the 
FAT.) 


The system doesn’t immediately delete the index from its buffer 
when the file is closed. 


Having the turbo FAT index in memory makes reopening the file 
and accessing information faster. 


Specify the hour when you want the file compressor to stop 
scanning enabled volumes for files that need to be compressed. 


Supported values: 0 to 23. 
Default: 6. 


Hours are specified by a 24-hour clock: 0 = midnight; 23 = 11 p.m. 
This parameter can be set in the STARTUP.NCF file, if desired. 


SET 





Parameter 





Use to 





Compression Daily Check Starting 
Hour = number 


Minimum Compression Percentage 
Gain = number 


Enable File Compression = value 


Specify the hour when you want the file compressor to start 
scanning enabled volumes for files that need to be compressed. 


Supported values: 0 to 23. 
Default: 0. 


Hours are specified by a 24-hour clock: 0 = midnight; 23 = 11 p.m. 


Note: If the Compression Daily Check Stop Hour parameter is 
the same as the Compression Daily Check Starting Hour, then 
the file compressor starts checking every day at the Compression 
Daily Starting Hour time and runs as long as necessary to finish 
all files that meet the compressible criteria. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Set the minimum percentage a file must compress to remain ina 
compressed state. 


Supported values: 0 to 50. 
Default: 20. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Specify whether file compression is suspended. 


Supported values: ON, OFF. 
Default: ON. 


ON allows file compression on compression-enabled volumes. 


OFF suspends compression; immediate compress requests are 
queued until value is reset to ON, when the files meeting criteria 
will be compressed. 


This parameter can be set in the STARTUP.NCF file, if desired. 
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Parameter 


Use to 





Maximum Concurrent Compressions 
= number 


Convert Compressed to 
Uncompressed Option = value 


Decompress Percent Disk Space 
Free to Allow Commit = number 
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Specify the maximum concurrent or simultaneous compressions 
allowed. 


Supported values: 1 to 8. 
Default: 2. 


Concurrent compressions can occur only if there are multiple 
volumes. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Specify what the system does with an uncompressed version of 
a file after the server has uncompressed it. 


Supported values: 


0 = Always leave the file compressed. 

1 = Leave the file compressed until second access if it is read 
only once during the time specified by the Days Untouched 
Before Compression parameter. 

2 = Always leave the file uncompressed. 


Default: 1 
This parameter can be set in the STARTUP.NCF file, if desired. 


Specify the percentage of free disk space required on a volume 
for file uncompression to permanently change compressed files 
to uncompressed. 


Supported values: 0 to 75. 
Default: 10. 


This parameter prevents newly uncompressed files from filling up 
the volume. 


This parameter can be set in the STARTUP.NCF file, if desired. 


SET 








Parameter 


Use to 





Decompress Free Space Warning 
Interval = number 


Deleted Files Compression Option = 
number 


Days Untouched Before 
Compression = number 


Allow Unowned Files To Be Extended 
= value 


Lock Parameters 


Specify the time between alerts when the file system is not 
changing compressed files to uncompressed because of 
insufficient disk space. 


Supported values: 0 seconds to 29 days 15 hours 50 minutes 
3.8 seconds. 
Default: 31 minutes 18.5 seconds. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Specify whether and when deleted files are compressed. 
Supported values: 


0 = Don’t Compress deleted files. 
1 = Compress deleted files the next day. 
2 = Compress deleted files immediately. 


Default: 1. 
This parameter can be set in the STARTUP.NCF file, if desired. 


Specify the number of days the system waits after a file was last 
accessed before it is compressed 


Supported values: 0 to 100000. 
Default: 14. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Specify whether files can be modified when the owner has been 
lost or deleted. 


Supported values: ON, OFF. 
Default: ON 


This parameter can be set in the STARTUP.NCF file, if desired. 


Lock parameters control 


@ How many open files each workstation can have 
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+ How many open files the system can handle 

@ How many record locks each connection can have 

@ How many record locks the system can handle 
There are three types of locks: 


@ File locks secure the file and prevent other stations from accessing 
it. 


@ Physical record locks control data access by multiple users. They 
prevent other users from accessing or changing a range of bytes (a 
record) in a file. 


Physical record locks are enforced by the system. If a user tries to 
access a range of bytes that is physically locked, the user receives 
an Access Denied error message. 


@ Logical record locks also control data access by multiple users. 
The application assigns a name to each section of data that needs 
to be locked. The application then locks this name whenever it 
accesses the data. 


Logical locks are enforced only to the extent that the application 
checks the name each time it needs access to data. 


See Table 2-11 for a description of lock parameters. 
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Table 2-11Lock Parameters 





Parameter 


Use to 





Maximum Record Locks Per 
Connection = number 


Maximum File Locks Per Connection 
= number 


Maximum Record Locks = number 


Control how many record locks a workstation can use at one time. 
(Use MONITOR to view how many record locks a station is using.) 


Supported values: 10 to 100000. 
Default: 500. 


Increase this parameter when an application can’t lock enough 
records and fails. 


Decrease this parameter if stations are using too many server 
resources. 


Control how many opened and locked files a station can use at 
one time. (Use MONITOR to view how many opened and locked 
files a station is using.) 


Supported values: 10 to 1000. 
Default: 250. 


Increase this parameter when an application can’t open enough 
files and fails. 


Decrease this parameter if stations are using too many server 
resources. 


Control how many record locks the operating system can handle. 
(Use MONITOR to view how many record locks a station is using 
on that server.) 


Supported values: 100 to 400000. 
Default: 20000. 


Increase this parameter if users have problems running 
applications and receive messages indicating that not enough 
record locks are available. 


Decrease this parameter if users are using too many server 
resources. 
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Parameter Use to 





Maximum File Locks = number Control how many opened and locked files the operating system 
can handle. (Use MONITOR to view the number of files that are 
open during peak usage.) 


Supported values: 100 to 100000. 
Default: 10000. 


Increase this parameter if the number of open files is near or 
equal to the default. 


Decrease this parameter to restrict the number of available server 
resources. 


Transaction Tracking Parameters 


@ A transaction is a set of write operations that must be completed 
together to maintain file and database integrity. 


@ Write operations consist not only of data and data records, but also 
of changes to the index and the key structures that are important 
to an application’s continual operation. 


@ The Transaction Tracking System™ (TTS) guarantees that a 
transaction is written to disk in its complete form or is backed out 
if incomplete. This ensures database integrity in case a failure 


occurs before a transaction is completed. 


See Table 2-12 for a description of transaction tracking parameters. 
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Table 2-12Transaction Tracking Parameters 


Parameter Use to 





Auto TTS Backout Flag = value Specify whether a crashed server with transactional files can 
automatically back out of incomplete transactions when the 
server is booted. 


Supported values: 


ON = The server backs out incomplete transactions when 
booting. 

OFF = The server waits for you to answer a prompt before it 
boots. 


Default: ON. 


You must set this parameter in STARTUP.NCF. You cannot set the 
parameter at the command line. 


TTS Abort Dump Flag = value Specify whether a file is created to log transactional backout data. 
Supported values: 


ON = The information is saved in TTS$LOG.ERR. 
OFF = The information backed out is not saved. 


Default: OFF. 


When a server fails during a data write to a file flagged 
Transactional, the system can back out the incomplete write. 


The backed-out information is written to file TTS$LOG.ERR on 
volume SYS:. You can print the file or view it with a text editor. 


Maximum Transactions = number Specify how many transactions can occur at the same time. 


Supported values: 100 to 10000. 
Default: 10000. 
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Parameter Use to 
TTS UnWritten Cache Wait Time = Specify how long a block of transactional data can be held in 
time memory. 


Supported values: 11 seconds to 10 minutes 59.1 seconds. 
Default: 1 minute 5.9 seconds. 


Some blocks of transactional data wait for other transactional 
blocks to be written first. 


If one of these blocks reaches its maximum time limit, other write 
requests are held up and this block is written to disk. 


TTS Backout File Truncation Wait Specify how long allocated blocks remain available for the TTS 
Time = time backout file when these blocks are not in use. 


Supported values: 1 minute 5.9 seconds to 1 day 2 hours 21 
minutes 51.3 seconds. 
Default: 59 minutes 19.2 seconds. 





Disk Parameters 


Disk parameters control one part of Hot Fix™ redirection. Hot Fix redirection 
can occur during a write request, a read request, or a read-after-write 
verification. 


@ Write redirection occurs when the disk reports an error during a 
write request. The system marks the block as bad and redirects the 
data to a different block. 


@ Read redirection occurs when a disk error happens during a read 
request. 


If the disk is mirrored, the system retrieves the data from the 
mirrored disk and redirects the data on the primary disk. If the 
disk isn’t mirrored, the data is lost, but the block is marked as bad. 


@  Read-after-write verify redirection occurs after data is written to 


disk. The data on disk is then read and compared to that in 
memory. 
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If the two dont match, the system marks the block as bad and redirects the data 
to a different block. 


See Table 2-13 for a description of disk parameters. 
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Table 2-13Disk Parameters 


Parameter 


Use to 





Enable Disk Read After Write Verify = 
value 


Remirror Block Size = value 


Concurrent Remirror Requests = 
value 


Mirrored Devices Are Out of Sync 
Message Frequency = time 
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Control whether information written to disk is compared with that 
in memory. Usually, you shouldn't disable this portion of Hot Fix. 


Supported values: ON, OFF. 
Default: ON. 


If your disks are mirrored and reliable and you need extra speed 
on disk writes, using OFF can almost double the speed of disk 
writes. 


Some disks and drivers provide their own read-after-write verify 
procedure. In this case, set the parameter to OFF, so the read- 
after-write-verify operation isn’t done twice. 


Changing this value affects only disks loaded after the parameter 
is changed. To set this value for currently loaded disks, use the 
Disk Information option of the MONITOR utility. See “MONITOR” 
on page 142 


You can set this parameter in the STARTUP.NCF file. 


Sets the remirror block size in 4 KB increments. (1=4 KB, 2=8 KB, 
8=32 KB, etc.) 


Supported values: 1 to 8. 
Default: 1. 


Sets the number of remirror requests per logical partition. 


Supported values: 2 to 32. 
Default: 4. 


Sets the frequency (in minutes) for checking out-of-sync devices. 


Supported values: 5 to 9999 minutes. 
Default: 30 minutes. 


You can set this parameter in the STARTUP.NCF file. 


SET 








Parameter Use to 





Ignore Disk Geometry = value Create nonstandard and unsupported partitions. 


Supported values: ON, OFF. 
Default: OFF. 


If you set this parameter to ON before modifying or creating a 
partition, the software ignores disk geometry when reading or 
writing the disk partition. This allows you to create nonstandard 
partitions. 


Caution: Setting this parameter to ON may harm other file 
systems contained on the disk. 


You can set this parameter in the STARTUP.NCF file. 


Enable IO Handicap Attribute = value Enable drivers and applications to set an attribute to inhibit read 
requests from one or more devices. 


Supported values: ON, OFF. 
Default: OFF. 


Setting this parameter to ON enables the inhibit attribute to 
function. Setting this parameter to OFF prevents the attribute from 
functioning. 


Do not set this attribute to ON unless instructed to do so by a 
device manufacturer. 


You can set this parameter in the STARTUP.NCF file. 





Time Synchronization Parameters 
Time parameters control time synchronization, the TMESYNC.CFG file, and 
time zone settings to insure that the time reported by all servers is consistent, 


or synchronized. (See Time Synchronization in Concepts.) 


See Table 2-14 for a description of time parameters. 
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Table 2-14Time Synchronization Parameters 


Parameter 


Use to 





TIMESYNC ADD Time Source = 
server name 


TIMESYNC Configuration File = path 


TIMESYNC Configured Sources = 
value 


TIMESYNC Directory Tree Mode = 
value 
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Specify a server as a time source. Use EDIT, rather than this 
parameter, to add a server to the time source list in the 
TIMESYNC.CFG file. 


Maximum: 48 characters. 


Specify the path where the TIMESYNC.CFG configuration file is 
located. 


Maximum: 255 characters. 


Example: SET TIMESYNC CONFIGURATION FILE = 
SYS:SYSTEM\TIMESYNC.CFG 


Specify what time sources the server listens to. 
Supported values: 


ON = The server ignores SAP time sources and relies on time 
sources custom-configured with the TIMESYNC Time Source 
parameter. 


OFF = The server listens to any advertising time source. 
Default: OFF. 

Control the use of SAP packets in the Directory tree. 
Supported values: 


ON = Time synchronization ignores SAP packets that don’t 
originate from within the Directory tree the server is on. 


OFF = The server can receive SAP packets from any time source 
on the network. 


Default: ON. 


Don’t set this parameter to OFF if SAP is set to ON. Using OFF 
could corrupt the time synchronization for this server’s Directory 
tree. 


SET 





Parameter 





Use to 





TIMESYNC Hardware Clock = value 


TIMESYNC Polling Count = number 


TIMESYNC Polling Interval = number 


TIMESYNC REMOVE Time Source = 
server name 


Controls hardware clock synchronization. 
Supported values: 


ON = The Primary and Secondary time servers set the hardware 
clock, and the Single Reference and Reference Servers set their 
time from the hardware clock at the beginning of each polling 
interval. 


OFF = Use only if this server uses an external time source (such 
as a radio clock). 


Default: ON. 


Specify how many time packets to exchange while polling. 
Increasing the number of packets adds unnecessary traffic to the 
network. 


Supported values: 1 to 1000. 
Default: 3. 


Specify the long polling interval, in seconds. 


Supported values: 10 to 2678400 seconds (31 days). 
Default: 600 seconds (10 minutes). 


All servers in the same tree must use the same setting. 
Delete a server as a time source. 


Use EDIT, rather than this parameter, to delete a server from the 
time source list in the TIMESYNC.CFG file. 


Maximum: 48 characters. 
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Parameter 


Use to 





TIMESYNC RESET = value 


TIMESYNC Restart Flag = value 


TIMESYNC Service Advertising = 
value 
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Reset time synchronization and clear the time source list. 


Use EDIT, rather than this parameter, to reset values in the 
TIMESYNC.CFG file and to remove the time source list from the 
file. 


Supported values: 


ON = Selected internal values are reset and the configured server 
list is cleared. Flag automatically resets to OFF. 


Default: OFF. 
Control restarts of time synchronization. 


Supported values: ON, OFF. 
Default: OFF. 


Set this parameter to ON only if you want to reload TIMESYNC 
without rebooting the server. 


Control time source advertising. 
Supported values: 


ON = The Single Reference, Reference, and Primary time source 
advertise using SAP. 


OFF = Use only if you are using a custom-configured list of time 
sources. 


Default: ON. 


Note: Secondary time services do not advertise. 


SET 





Parameter 





Use to 





TIMESYNC Synchronization Radius 
= number 


TIMESYNC Time Adjustment = [+ or - 
] hour :minute :second [at month /day 
/year hour :minute :second AM or 
PM] 


TIMESYNC Time Source: server 
name 


Control the maximum time adjustment (in milliseconds) a server 
is allowed while still being considered synchronized. 


Supported values: 0 to 2147483647 milliseconds. 
Default: 2000. 


Increase this parameter to allow a wider margin of error for time 
synchronization between servers. 


Important: Lowering the synchronization radius increases the 
chance of servers losing synchronization due to randomness 
between clocks. 


Setting the synchronization radius for under 2000 milliseconds (2 
seconds) is not recommended. 


Set the synchronization radius for under 2 seconds only if you are 
using an application that uses synchronized time stamps which 
do not tolerate a 2-second deviation between time sources. 


Specify when a time adjustment will take place. 


Note: You cannot use this parameter on a Secondary time 
server. 


Maximum: 99 characters. 
Default: None scheduled. 


Use this parameter sparingly to correct network-wide time errors. 


Default date and time is six polling intervals or 1 hour (whichever 
is longer) from the current time. 


Misuse of this parameter can corrupt time synchronization and 
the order of events on your network. 


Specify a server as time source. If no server name is entered, the 
parameter displays the list of configured servers. 


Use EDIT, rather than this parameter, to add a server to the 
configuration list in the TIMESYNC.CFG file. 


Maximum: 48 characters. 
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Parameter 


Use to 





TIMESYNC Type = type of time 
source 


TIMESYNC Write Parameters = value 


TIMESYNC Write Value = number 


Time Zone = time zone string 
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Specify the default time source type. 


Use EDIT, rather than this parameter, to specify the default time 
source type in the TIMESYNC.CFG file. 


Supported types: Reference, Primary, Secondary, Single 
Reference. 

Maximum: 23 characters. 

Default: Single Reference. 


Specify whether parameters specified by the TIMESYNC Write 
Value parameter are written to the configuration file. 


Supported values: ON, OFF. 
Default: OFF. 


Control which parameters are written by TIMESYNC Write 
Parameters. 


Supported values: 


1 = Write internal parameters only. 
2 = Write configured time sources only. 
3 = Write both parameters and configured time sources. 


Default: 3 

Specifies the time zone string, which indicates: 
+ The abbreviated time zone name. 

+ The offset from Universal Time (UTC). 


The alternate abbreviated time zone name to be used when 
daylight saving time is in effect. 


Maximum: 80 characters. 
Default: No Time Zone. 


This parameter causes UTC time to be recalculated from local 
time. 


You can set this parameter in the STARTUP.NCF file. 


SET 





Parameter 





Use to 





Default Time Server Type = type of 
time source 


Start of Daylight Savings Time = date 
and time 


End of Daylight Savings Time = date 
and time 


Daylight Savings Time Offset = [+ or - 
] hour :minute :second 


Specify the default time synchronization server type. This 
parameter can be overridden by other time synchronization 
parameters. 


Supported types: Reference, Primary, Secondary, Single 
Reference. 


Maximum: 50. 
Default: Secondary. 


You can set this parameter in the STARTUP.NCF file. 


Specify the local date and time when the change to daylight 
saving time should occur. 


Maximum: 79 characters. 


Important: You must set both the start and end of daylight saving 
time before either date is actually scheduled. 


Specify the local date and time when the change from daylight 
saving time should occur. 


Maximum: 79 characters. 


Important: You must set both the start and the end of daylight 
saving time before either date is actually scheduled. 


Control the offset applied to time calculations when daylight 
saving time is in effect. 


Default: +1:00:00. 


This parameter causes UTC time to be recalculated from local 
time. 


You can set this parameter in the STARTUP.NCF file. 
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Parameter 


Use to 





Daylight Savings Time Status = value 


New Time With Daylight Savings 
Time Status = value 


NCP Parameters 


Indicate whether daylight saving time is in effect. 


Supported values: ON, OFF. 
Default: OFF. 


If this parameter is set to ON, you should also use the Daylight 
Savings Time Offset parameter. 


Changing the daylight saving time status does not change the 
local time. 


You can set this parameter in the STARTUP.NCF file. 


Control the adjustment of local time when daylight saving time is 
in effect. 


Supported values: ON, OFF. 
Default: OFF. 


ON = Adjust the local time by adding or subtracting the Daylight 
Saving Time Offset parameter. 


With NetWare Core Protocol™ (NCP) parameters, you can 


@ Control NCP™ packets 


@ Control boundary checking 


@ Assign the NCP Server Packet Signature levels 


See Table 2-15 for a description of NCP parameters. 
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Table 2-15NCP Parameters 


Parameter 


Use to 





NCP File Commit = value 


Display NCP Bad Component 
Warnings = value 


Reject NCP Packets with Bad 
Components = value 


Display NCP Bad Length Warnings = 
value 


Control whether applications can flush pending file writes to disk. 


Supported values: ON, OFF. 
Default: ON. 


If the value is set to ON then when a File Commit NCP is issued, 
a file is sent from cache to disk immediately, instead of waiting for 
the cache manager to send it to disk later. 


Control whether NCP bad component alert messages are 
displayed. 


Supported values: ON, OFF. 
Default: OFF. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Specify whether NCP packets that fail component checking are 
rejected. 


Supported values: ON, OFF. 
Default: OFF. 


This parameter must be set to ON for the NetWare operating 
system to run in the Enhanced Security configuration. If the 
Enable SECURE.NCF parameter is set to ON, the Reject NCP 
Packets with Bad Components parameter is automatically set to 
ON at server startup. The Enable SECURE.NCF parameter is 
located in the Miscellaneous parameters. 


This parameter can be set in the STARTUP.NCF file, if desired. 
Control whether NCP bad length alert messages are displayed. 


Supported values: ON, OFF. 
Default: OFF. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Chapter 2: Utilities 351 


SET 








Parameter 


Use to 





Reject NCP Packets with Bad 
Lengths = value 


Maximum Outstanding NCP 
Searches = number 
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Specify whether NCP packets that fail boundary checking are 
rejected. This parameter can be used as a debugging tool. 


Supported values: ON, OFF. 
Default: OFF. 


This parameter must be set to ON for the NetWare operating 
system to run in the Enhanced Security configuration. If the 
Enable SECURE.NCF parameter is set to ON, the Reject NCP 
Packets with Bad Lengths parameter is automatically set to ON at 
server startup. The Enable SECURE.NCF parameter is located in 
the Miscellaneous parameters. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Specify the maximum number of NCP directory searches that can 
be processed simultaneously. 


Supported values: 10 to 1000. 
Default: 51. 


Normally, only one NCP directory search occurs at a time. 


Increase the default only if you use applications that support 
multiple outstanding directory search operations and you have 
problems with corrupted or invalid directory information. 


SET 





Parameter 





Use to 





NCP Packet Signature Option = 
number 


Enable IPX Checksums = number 


Control the NCP packet signature level on the server. 
Supported values: 
0 = Server doesn’t sign packets (regardless of the client level). 


1 = Server signs packets only if the client requests it (client level 
is 2 or higher). 


2 = Server signs packets if the client is capable of signing (client 
level is 1 or higher). 


3 = Server signs packets and requires all clients to sign packets 
(or logging in will fail). 


Default: 1. 


NCP Packet Signature prevents packet forgery on servers and 
clients using NCP by requiring server and client to sign each NCP 
packet. 


Note: Because Packet Signature consumes CPU resources and 
slows performance on both client and server, NCP Packet 
Signature is optional. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Specify the enabling of IPX checksums. 
Supported values: 


0 = For no checksums. 
1 = To checksum if enabled at the client. 
2 = To require checksums. 


Default: 1. 
This parameter can be set in the STARTUP.NCF file, if desired. 
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Parameter Use to 





Allow Change to Client Rights = va/ue Control whether a job server can assume the rights of a client for 
NCP packet signatures. 


Supported values: ON, OFF. 
Default: ON. 


Note: Some job servers and third-party applications can’t 
function without changing to client rights. 


Using OFF may prevent some job servers from getting access to 
the files they need, but it prevents the forging of a packet through 
the job or print server. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Allow LIP = value Set Large Internet Packet (LIP) support. 


Supported values: ON, OFF. 
Default: ON. 


This parameter can be set in the STARTUP.NCF file, if desired. 


Miscellaneous Parameters 


These parameters include various alert settings, as well as other miscellaneous 
parameters. 


If you have loaded the NetWare Symmetric MultiProcessing (SMP) system, 
this category includes SMP parameters. 


See the parameter descriptions in Table 2-16 . 
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Table 2-16Miscellaneous Parameters 


Parameter Use to 





Command Line Prompt Default Specify a default response to an optional command in a .NCF file. 


Choice = value , , a. i 
An optional command in a .NCF file is preceded by a question 


mark (?). The question mark causes the file to prompt you to 
execute the command. For information about optional commands 
in .NCF files, see Maintaining the NetWare Server in Supervising 
the Network . 


Supported Values: ON, OFF. 
Default: ON. 


ON means the default response to the command prompt is Y 
(yes). If the user does not respond to the prompt within a specified 
time period, the command is executed by default. 


OFF means the default response to the command prompt is N 
(no). If the user does not respond to the prompt within a specified 
time period, the command is not executed. 


To specify the time period before the response is executed, use 
the Command Line Prompt Time Out parameter. 


Command Line Prompt Time Out = Specify how long a .NCF file waits before executing the default 
time response to an optional command. 


An optional command in a .NCF file is preceded by a question 
mark (?). The question mark causes the file to prompt you to 
execute the command. For information about optional commands 
in .NCF files, see Chapter 7, Maintaining the NetWare Server , in 
Supervising the Network . 


Supported Values: 0 to 4294967295 seconds. 
Default: 10 seconds. 


Sound Bell for Alerts = value Control whether a bell sounds when an alert message appears on 
the console. 


Supported values: ON, OFF. 
Default: ON. 
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Use to 





Replace Console Prompt with Server 
Name = value 


Alert Message Nodes = number 


Worker Thread Execute In a Row 
Count = number 


Halt System on Invalid Parameters = 
value 


Upgrade Low Priority Threads = value 
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Control whether the console prompt is replaced with the NetWare 
server name. 


Supported values: ON, OFF. 
Default: ON. 


You can set this parameter in the STARTUP.NCF file. 


Specify the number of alert message nodes that have been 
previously allocated. 


Supported values: 10 to 256. 
Default: 20. 


You can set this parameter in the STARTUP.NCF file. 


Specify the number of times the scheduler consecutively 
dispatches new work before allowing other threads to run. 


Supported values: 1 to 20. 
Default: 10. 


Specify whether to stop the system when invalid parameters are 
detected. 


Supported values: 


ON = You want the system to halt when an invalid parameter or 
condition is detected. 


OFF = You want the system to display an alert and continue 
running when an invalid parameter or condition is detected. 


Default: OFF. 
You can set this parameter in the STARTUP.NCF file. 


Specify whether low-priority threads are scheduled at regular 
priority. 


Some modules can freeze up low-priority threads, causing file 
compression to shut down and other problems. 


Supported values: ON, OFF. 
Default: OFF. 


SET 





Parameter 





Use to 





Display Relinquish Control Alerts = 
value 


Display Incomplete IPX Packet Alerts 
= value 


Control whether messages about CPU control are sent to the 
server console. This parameter can be used as a debugging tool. 


Supported values: 


ON = Use if you’re writing your own loadable modules. 
OFF = Use if you’re not writing your own loadable modules. 


Default: OFF. 


If a module uses the processor for more than 0.4 second without 
relinquishing control to other processes, the following types of 
messages appear: 


<process name > Process did not relinquish control frequently. 
Module: <module name > 
Code offset in module: <memory address > 


You can set this parameter in the STARTUP.NCF file. 


Specify whether alert messages are displayed when IPX receives 
incomplete packets. This parameter can be used as a debugging 
tool. 


Supported values: ON, OFF. 
Default: ON. 


You can set this parameter in the STARTUP.NCF file. 
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Display Old API Names = value 


Developer Option = value 
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Control messages about NetWare 3 API calls. This parameter 
can be used as a debugging tool. 


Supported values: 


ON = Use if you write your own modules and you are upgrading 
NetWare 3.0 modules to modules using newer APIs. 


OFF = Use if you aren’t upgrading modules. 
Default: OFF 


The following types of messages appear when a module is 
loaded that uses the old APIs: 


Module is using old API: SetInterruptVector 
Module is using old API: ReturnPermanentMemory 
Module is using old API: AllocateReturnablePermMemory 


The old APIs work, but more slowly than the new APIs. If you 
receive these messages, contact the vender of the module. 


You can set this parameter in the STARTUP.NCF file. 


Control whether options associated with a developer environment 
are enabled. 


Supported values: ON, OFF. 
Default: OFF. 


You can set this parameter in the STARTUP.NCF file. 
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Parameter 





Use to 





Display Spurious Interrupt Alerts = 
value 


Display Lost Interrupt Alerts = value 


Control alert messages about spurious interrupts. 


Supported values: ON, OFF. 
Default: ON. 


A spurious interrupt occurs when hardware in the server creates 
an interrupt that is defined and reserved for another device. 


Spurious interrupts generate the following message: Spurious 
hardware interrupt <number> detected. 


This message indicates a serious error in the hardware. 


If your server console displays this message, remove all add-on 
boards and run SERVER. 


If the message doesn’t appear, add the boards one at a time to 
determine the hardware creating the spurious interrupt. Then 
contact the vendor. 


Set the parameter to OFF while you are waiting for a resolution. 


You can set this parameter in the STARTUP.NCF file. 


Control alert messages about lost interrupts. 


Supported values: ON, OFF. 
Default: ON. 


A lost interrupt occurs when a driver or board requests a service 
with an interrupt call and then drops the request before the CPU 
can respond. 


Lost interrupts generate the following message: Interrupt 
controller detected a lost hardware interrupt. 


This message indicates a hardware or driver problem that could 
degrade performance. 


Unload all drivers and then reload them one at a time to 
determine which driver has a problem. Then contact the vender 
of the driver. 


Set the parameter to OFF while you are waiting for a resolution. 


You can set this parameter in the STARTUP.NCF file. 
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Parameter 


Use to 





Pseudo Preemption Count = number 


Global Pseudo Preemption = value 


Minimum Service Processes = 
number 


Maximum Service Processes = 
number 


New Service Process Wait Time = 
number 
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Specify the number of times threads are allowed to make file read 
or write system calls before a relinquish is forced. 


Supported values: 1 to 4294967295. 
Default: 10. 


Specify whether or not all threads use pseudo preemption. 


Supported values: ON, OFF. 
Default: OFF 


Specify the minimum number of service processes the operating 
system can create without having to wait for the time specified by 
the New Service Process Wait Time parameter. 


Supported values: 10 to 500. 
Default: 10. 


Specify the maximum number of service processes that the 
operating system can create. (View the number of service 
processes in MONITOR.) 


Supported values: 5 to 1000. 
Default: 40. 


Decrease this parameter temporarily if the server is low on 
memory. If the server is always low on memory, add memory. 


Increase this parameter if the number of service processes is at 
the maximum. 


Increasing this number helps only if more than 20 requests are 
being delayed simultaneously for a disk I/O to be completed. 


Specify how long the system should wait to make an allocation 
when it receives a request for another service process. 


Supported values: 0.3 second to 20 seconds. 
Default: 2.2 seconds. 


SET 





Parameter 





Use to 





Automatically Repair Bad Volumes = 
value 


Enable SECURE.NCF=value 


Allow Audit Passwords = value 


Specify whether VREPAIR runs automatically on a volume that 
fails to mount. 


Supported values: ON, OFF. 
Default: ON. 


This parameter must be set to ON for the NetWare operating 
system to run in the Enhanced Security configuration. If the 
Enable SECURE.NCF parameter is set to ON, the Automatically 
Repair Bad Volumes parameter is automatically set to ON at 
server startup. The Enable SECURE.NCF parameter is located in 
the Miscellaneous parameters. 


You can set this parameter in the STARTUP.NCF file. 


Execute the SECURE.NCF file at server startup. 


Supported values: ON, OFF. 
Default: OFF. 


When this parameter is set to ON, the SECURE.NCF file is 

executed at server startup. The SECURE.NCF file sets the 

options required to run the NetWare operating system in the 
Enhanced Security configuration. 


For more information about the Enhanced Security configuration, 
seeAuaditing the Network . 


You can set this parameter in the AUTOEXEC.NCF or 
STARTUP.NCF file. 


Specify whether passwords can be used to identify auditors. 


Supported values: ON, OFF. 
Default: OFF. 


This parameter must be set to OFF for the NetWare operating 
system to run in the Enhanced Security configuration. If the 
Enable SECURE.NCF parameter is set to ON, the Allow Audit 
Passwords parameter is automatically set to OFF at server 
startup. The Enable SECURE.NCF parameter is located in the 
Miscellaneous parameters. 
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Parameter 


Use to 





Allow Unencrypted Passwords = 
value 


SMP Stack Size = number 
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Control the use of unencrypted passwords. If your servers run 
NetWare 3.1x, use OFF. 


Supported values: ON, OFF. 
Default: OFF. 


This parameter must be set to OFF for the NetWare operating 
system to run in the Enhanced Security configuration. If the 
Enable SECURE.NCF parameter is set to ON, the Allow 
Unencrypted Passwords parameter is automatically set to OFF at 
server startup. The Enable SECURE.NCF parameter is located in 
the Miscellaneous parameters. 


If your servers run versions of NetWare earlier than NetWare 3.0 
and you leave the parameter set to OFF, your users might have 
problems logging in. 


If you have servers that run NetWare 2.12 and later versions, copy 
the NetWare 3.1x utilities to those servers and set this parameter 
to OFF. 


If you don’t copy NetWare 3.1x utilities to NetWare 2 servers, use 
ON. 


Specify the minimum stack size for threads created by the SMP 
kernel APIs. Allocation requests for stacks smaller than this size 
will return the smallest value specified by this SET parameter. 


Do not change this parameter value unless an application 
package instructs you to specify a certain minimum stack size. 


A NetWare Loadable Module™ (NLM) program can specify stack 
sizes on a per-thread basis independently of this parameter. 


Minimum value: 8192. 
Maximum value: 1048576. 
Default: 8192. 


SET 





Parameter 





Use to 





SMP Polling Count = number 


SMP NetWare Kernel Mode = value 


SMP Flush Processor Cache = value 


Specify the maximum number of thread switches that will occur 
before NetWare runs symmetric polling procedures. 


Do not change this value unless an application package instructs 
you to do so. 


Polling procedures affected by this parameter include network 
board, disk adapter, and internal maintenance routines. 


Minimum value: 70 
Maximum value: 200 
Default: 70 


Specify whether processor 0 is dedicated to native NetWare, 
shared by both the SMP and native NetWare kernels, or shared 
but with priority given to native NetWare. 


Dedicated means native NetWare has exclusive access to 
processor 0. 


Shared means native NetWare threads and SMP threads share 
processor 0, and SMP threads preempt native NetWare threads. 


Priority means that native NetWare threads have priority while 
sharing processor 0. This setting is most useful when your system 
runs more than seven processors. 


Supported values: Dedicated, Shared, Priority 
Default: Shared 


Issue a WBINVD instruction that will cause the entire level 1 and 
level 2 processor caches to be flushed into core memory on 
processor shutdown. This is often necessary in systems that do 
not maintain the cache controller in a warm state following 
processor shutdown. 


Do not change this value unless your hardware documentation 
instructs you to do so. 


Supported values: ON, OFF 
Default: OFF 
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Parameter 


Use to 





SMP Intrusive Abend Mode = value 


SMP Developer Option = value 
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Specify whether the server starts the SMP debugger when the 
server abends. 


When this parameter is set to ON, the server starts the SMP 
debugger whenever the system abends. 


When this parameter is set to OFF, the server does not start the 
debugger. Instead, it halts the offending thread and continues to 
run. However, if the system abends during an interrupt, the server 
starts the debugger even if the parameter is set to OFF. 


To exit the debugger, type x at the debugger prompt. 


For more information about the SMP debugger, see the NetWare 
SMP Software Developer Kit. 


Supported values: ON, OFF 
Default: ON 


Specify whether the server starts the SMP debugger both when 
the server abends and when the server memory protection 
detects a memory fault. 


When this parameter is set to ON, the server starts the SMP 
debugger both when the server abends and when the server 
memory protection detects a memory fault. 


When this parameter is set to OFF, the server does not start the 
debugger. Instead, it halts the offending thread and continues to 
run. However, if the server abends during an interrupt, the server 
starts the debugger even if the parameter is set to OFF. 


To exit the debugger, type x at the debugger prompt. 


For more information about the SMP debugger, see the NetWare 
SMP Software Developer Kit. 


Supported values: ON, OFF 
Default: OFF 


SET 








Parameter Use to 





SMP Memory Protection = value Enable memory protection. 


When this parameter is set to ON, the server automatically 
handles page faults and general protection interrupts and tries to 
halt the thread causing the problem. The processor continues to 
operate. However, if the problem occurs during an interrupt, the 
server starts the SMP debugger. 


When this parameter is set to OFF, memory protection is 
disabled. 


To exit the debugger, type at the debugger prompt. 


For more information about the SMP debugger, see the NetWare 
SMP Software Developer Kit. 


Supported values: ON, OFF 
Default: OFF 


Error Handling Parameters 


Error handling parameters control the size of error logs and what happens when 
logs exceed the specified size. 


See Table 2-17 for descriptions of error handling parameters. 
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Table 2-17Error Handling Parameters 


Parameter 


Use to 





Server Log File State = number 


Volume Log File State = number 


Volume TTS Log File State = number 
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Control what happens when the SYS$LOG.ERR file is larger than 
the size specified by the Server Log File Overflow Size parameter. 


Supported values: 


0 = Use to leave SYS$LOG.ERR as is. 
1 = Use to delete SYS$LOG.ERR. 
2 = Use to rename SYS$ERR.LOG. 


Default: 1 
You can set this parameter in the STARTUP.NCF file. 


Control what happens when the VOL$LOG.ERR file is larger than 
the size specified by the Volume Log File Overflow Size 
parameter. 


Supported values: 


0 = Use to leave VOL$LOG.ERR as is. 
1 = Use to delete VOL$LOG.ERR. 
2 = Use to rename VOL$ERR.LOG. 


Default: 1. 
You can set this parameter in the STARTUP.NCF file. 


Control what happens when the TTS$LOG.ERR file is larger than 
the size specified by the Volume TTS Log File Overflow Size 
parameter. 


Supported values: 


0 = Use to leave TTS$LOG.ERR as is. 
1 = Use to delete TTS$LOG.ERR. 
2 = Use to rename TTS$ERR.LOG. 


Default: 1. 
You can set this parameter in the STARTUP.NCF file. 


SET 





Parameter 





Use to 





Server Log File Overflow Size = 
number 


Volume Log File Overflow Size = 
number 


Volume TTS Log File Overflow Size = 
number 


Enable Deadlock Detection = va/ue 


Auto Restart After Abend Delay Time 
= number 


Specify the maximum size of the SYS$LOG.ERR file before the 
action specified by the Server Log File State parameter occurs. 


Supported values: 65536 to 4294967295. 
Default: 4194304. 


You can set this parameter in STARTUP.NCF. 


Specify the maximum size of the VOL$LOG.ERR file before the 
action specified by the Volume Log File State parameter occurs. 


Supported values: 65536 to 4294967295. 
Default: 4194304. 


You can set this parameter in the STARTUP.NCF file. 


Specify the maximum size of the TTS$LOG.ERR file before the 
action specified by the Volume TTS Log File State parameter 
occurs. 


Supported values: 65536 to 4294967295. 
Default: 4194304. 


You can set this parameter in the STARTUP.NCF file. 
Detect deadlocks in code. 


Supported values: ON, OFF 
Default: OFF 


This parameter is used by software developers only. 


Specify the amount of time (in minutes) before the server is 
brought down after an abend, if the Auto Restart After Abend 
parameter is in effect. 


Supported values: 2 to 15 minutes. 
Default: 2 minutes. 


Regardless of what time is set, the server sends a message every 
2 minutes to warn users that the server will be brought down. 
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Parameter 


Use to 





Auto Restart After Abend = value Cause the system to respond automatically to an abend. 





Supported values: 

0 = The system does not automatically respond to the abend. 

1 = After an abend, the system determines the source of the 
abend. Based on findings, the system either keeps the computer 
running or shuts down the computer and attempts to restart it. 

2 = After an abend, the system always shuts down the computer 
and attempts to restart it. 

Default: 1 


For value 1 or 2 to take effect, the Developer Option parameter 
(located in the Miscellaneous category of parameters) must also 
be set to ON. 


If the server is to be shut down, the system sends a message 
every 2 minutes to warn all connections. 


To configure the amount of time the system waits before shutting 
down the server, use the Auto Restart After Abend Delay Time 
parameter. 


After an abend, the screen displays information about the abend. 
This information is sent to the ABEND.LOG file on the C: drive. 
Once the server is shut down and restarted, the ABEND.LOG file 
is transferred to SYS:SYSTEM. 


Important: Because the server can abend and be restarted 
automatically, the system administrator should periodically check 
the ABEND.LOG file or the General Information screen of 
MONITOR to find out if there have been any abends. 


Novell Directory Services Parameters 
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Novell® Directory Services (NDS) parameters allow you to do the following: 


+ 


+ 


Control the NDS trace file. 


Set time intervals for maintenance processes that reclaim disk 
space, remove external references, and check the consistency of 
backlinks. 


SET 





+ 


+ 


Set NDS synchronization intervals and restrictions. 
Specify the number of NCP retries before timeout. 
Mark the status of other servers in the namebase as UP or DOWN. 


Specify bindery services contexts. 


See Table 2-18 for descriptions of NDS parameters. 


Chapter 2: Utilities 369 


SET 





Table 2-18Novell Directory Services Parameters 


Parameter 


Use to 





NDS Trace to Screen = ON/OFF 


NDS Trace to File = ON/OFF 


NDS Trace Filename = path\name 


NDS Client NCP Retries = number 
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Enable the NDS trace screen; this displays information about 
NDS events on the monitor. 


Supported values: ON, OFF. 
Default: OFF. 


Send messages about NDS events to the NDS trace file on the 
SYS: volume. The default file is SYSTEM\DSTRACE.DBG. 


Supported values: ON, OFF. 
Default: OFF. 


The file path and name can be changed with the NDS Trace 
Filename parameter. 


The file is circular; it grows to a maximum length of approximately 
500 KB and then starts to overwrite itself at the beginning of the 
file. 


If this parameter is set to ON, the trace information is also scrolled 
on the screen. 


Set the path and name of the NDS trace file on SYS: volume. 


Maximum length: 254. 
Default: SYSTEM\DSTRACE.DBG. 


Specify the number of NCP retries before the NDS client times 
out a connection. 


Supported values: 1 to 20. 
Default: 3. 


Lower settings are useful for smaller networks or those in which 
cables are disconnected frequently. 


Higher settings are useful for larger networks with heavy traffic. A 
setting of 4, 5, or 6 should be sufficient for large networks. 


SET 





Parameter 





Use to 





NDS External Reference Life Span = 
number in hours 


NDS Inactivity Synchronization 
Interval = number in minutes 


NDS Synchronization Restrictions = 
OFF/ON, version number list 


Specify the number of hours unused external references are 
allowed to exist before being removed. 


Supported values: 1 to 384 hours. 
Default: 192. 


External references are local IDs assigned to users when they 
access other servers. When users no longer have access, the 
external references should be removed. 


Specify the maximum elapsed time between exhaustive 
synchronization checks. As soon as you change this value, the 
system executes the synchronization check. Synchronization 
checks then recur at the specified interval. 


Supported values: 2 to 1440 minutes. 
Default: 30. 


If the system has replicas across a WAN link, this value should be 
set as high as 240 minutes (4 hours) to reduce WAN traffic. 


Specify which versions of Novell Directory Services the server 
can synchronize with. 


Supported values: OFF, ON, list of version numbers. 
Maximum length of version number list: 131 characters. 


Default: OFF. 


To determine what version is currently loaded on a server, type 
MODULES at the server prompt. The Novell Directory Services 
version number is displayed under the heading DS.NLM. 


If this parameter is set to OFF, the server synchronizes with all 
versions available. 


If this parameter is set to ON, the server synchronizes only with 
those versions specified as parameters to the ON value. 


Example: ON,420,421 
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Parameter 


Use to 





NDS Servers Status = value 


NDS Janitor Interval = number in 
minutes 


NDS Backlink Interval = number in 
minutes 
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Mark the status of all server objects in the local namebase as UP 
or DOWN. 


Supported values: UP, DOWN 


Use this parameter to reset the status of all the servers if the 
status of one server isn’t accurately recognized by the system. 


For example, if a server is up but the system recognizes it as 
down, set this parameter to mark all servers as up. 


Subsequently, the system would reassess the status of all servers 
and change the status to down for those servers that were truly 
down. 


Set the interval in minutes at which the janitor process is 
executed. The janitor process is executed as soon as you change 
this value and then recurs at the specified interval. 


Supported values: 1 to 10080 minutes. 
Default: 60. 


The janitor process cleans up unused records, reclaims disk 
space, and purges objects flagged for deletion. 


Set the interval in minutes at which backlink consistency checking 
is performed. Backlink consistency checking is executed as soon 
as you change this value. It then recurs at the specified interval. 


Supported values: 2 to 10080 minutes. 
Default: 780. 


A backlink indicates that an object in a replica has an ID ona 
server where the replica doesn't exist. 


This process creates needed backlinks and deletes unnecessary 
ones. 


SET 





Parameter 





Use to 





NDS Trace File Length to Zero = OFF 


Check Equivalent to Me = value 


Bindery Context = context;context 


Delete the contents of the trace file. This parameter does not 
delete the file itself. As soon as the file is cleared, the parameter 
resets to OFF. 


Supported values: ON, OFF. 
Default: OFF. 


To use this parameter, you must also set the NDS trace to file 
parameter to ON, because the trace file must be open for the 
system to delete its contents. 


Enforce checking of the Equivalent To Me attribute on 
authentication. 


Supported values: ON, OFF. 
Default: OFF 


Set this parameter to ON for enhanced security. 


If this parameter is set to ON, DSREPAIR must be used to 
synchronize the Equivalence attribute and the Equivalent To Me 
attribute. 


Setting this parameter to ON might adversely affect 
communication performance. 


Specify one or more containers to be used by Novell Directory 
Services when it provides bindery services. 


Maximum: 2047 characters. Up to 16 contexts. 


Multiple contexts are separated by semicolons. To set multiple 
contexts, you must have a replica of the container you specify in 
the context on the same partition. 


Example: 
SET BINDERY CONTEXT = OU=SALES_LA.OU=SALES. 
O=NOVELL_US;OU=ACCOUNTING.O=NOVELL 


This parameter can be set in the STARTUP.NCF file. 
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SFT Ill Parameters 


A NetWare 4.2 SFT III™ system provides additional SET parameters to help 
you test and customize your mirrored server environment. 


Some SET parameters affect only one engine (the MSEngine or the IOEngine). 
A few parameters can be set in both engines (see “SFT II Parameters Settable 
in Both Engines” ). 


You must execute SET parameters in the correct engine. To toggle to the 
appropriate console display JOEngine or MSEngine), use the <Alt>+<Esc> 
keys before typing a SET command. 


The NetWare 4.2 SET parameters listed in previous sections can also be used 
with a NetWare SFT III system. 


Changing one SFT III SET parameter may affect other parameters. As a general 
rule, don’t change more than one parameter at a time. 


MSEngine Parameters Only Settable at Startup 
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The following MSEngine SET parameters are settable only at startup: 


Minimum Packet Receive Buffers 
Cache Buffer Size 

Maximum Subdirectory Tree Depth 
Auto TTS Backout Flag 

Concurrent Remirror Requests 


To change the default for these parameters, put the SET parameter in the 
MSSTART.NCF file. 


If you change the Minimum Packet Receive Buffers parameter in the 
MSSTART.NCF file, you must also put the same SET parameter in the 
IOSTART.NCF file. 


Changes to the MSSTART.NCF file do not take effect until after you bring 
down both servers and reactivate them. 


SET 





lOEngine Parameters Only Settable at Startup 


The following IOEngine SET parameters are settable only at startup: 


Minimum Packet Receive Buffers 
Auto Register Memory Above 16 Megabytes 


To change the default for these parameters, include the SET parameter in the 


IOSTART.NCF file and restart that server. 


SFT Ill Parameters Settable in Both Engines 


The following parameters can be set in either the IOEngine or the MSEngine, 
or both engines. In most cases, the parameter setting in the IOEngine and the 


MSEngine should match. 


Maximum Packet Receive Buffers 
Minimum Packet Receive Buffers 
Allow Invalid Pointers 

Read Fault Notification 

Read Fault Emulation 

Write Fault Notification 

Write Fault Emulation 

Sound Bell for Alerts 

Replace Console Prompt With Server Name 
Alert Message Nodes 

Worker Thread Execute in a Row Count 
Halt System on Invalid Parameters 
Upgrade Low Priority Threads 

Display Relinquish Control Alerts 
Display Incomplete IPX Packet Alerts 
Display Old API Names 


Related SFT Ill Wait Time Parameters 


Six SFT III SET parameters are closely related: 


SFT3 Error Wait Time (default: 3 seconds) 
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MSL Error Wait Time (default: 0.8 second) 

Secondary Take Over Wait Time (default: 1 second) 

IPX Internet Down Wait Time (default: 4 seconds) 

MSL Deadlock Wait Time (default: 5 seconds) 

Check LAN Extra Wait Time (default: 0 seconds + 5 seconds) 


Because their wait time settings affect server switchover, you should 
understand the interrelationships of these parameters before you change any of 
their default settings. 


+ 


Parameter Descriptions 
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The SFT3 Error Wait Time automatically adjusts the time of the 
other five wait time parameters. This parameter should be 
adjusted only for systems experiencing multiple timeouts. 


Of the related wait time values, the MSL Error Wait Time should 
be the shortest. It should be shorter by 1 second than the 
Secondary Take Over Wait Time. 


Both the MSL Error Wait Time and the Secondary Take Over Wait 
Time should be shorter than the IPX Internet Down Wait Time. 


For hardware failures, you need to find out if the Mirrored Server 
Link™ (MSL) is down (so the secondary server can shut down) 
before you start checking the LAN hardware. Therefore, the MSL 
Error Wait Time also should be shorter than the Check LAN Extra 
Wait Time. 


For software failures, you need to find out if the LAN is down 
before you find out if the MSL is down. Otherwise, both servers 
could fail at the same time. Therefore, the IPX Internet Down Wait 
Time should be shorter than the MSL Deadlock Wait Time. 


SFT III SET parameters are described in the following tables: 


MSEngine Communication Parameters, Table 2-19 on page 378 
MSEngine Miscellaneous Parameters (SFT III), Table 2-20 on page 378 
IOEngine Communication Parameters, Table 2-21 on page 380 


IOEngine Memory Parameters, Table 2-22 on page 381 


SET 





IOEngine Mirrored Server Parameters (SFT III), Table 2-23 on page 382 


IOEngine Mirrored Servers Error Recovery Options Parameters (SFT 
III), Table 2-24 on page 388 

IOEngine Mirrored Servers Test Options Parameters (SFT III), Table 2-25 
on page 392 

IOEngine Error Handling Parameters (SFT III), Table 2-26 on page 394 
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Table 2-19MSEngine Communication Parameters (SFT III) 


Parameter 


Use to 





Clear Extra ECB Space = number 





Specify whether to fill the leftover space in a receive event control 
block (ECB) with zeroes to prevent abends caused by undersized 
packets. 


Supported values: 0 to 2. 
Default: 1. 


0 = Don't fill the leftover space in the ECB with zeroes. 
1 = Fill up to 64 extra bytes in the ECB with zeroes. 
2 = Fill the rest of the ECB with zeroes. 


To improve server performance, set this parameter to 0. To 
prevent recurring MSEngine outputs different errors, set it to 2. 


Table 2-20MSEngine Miscellaneous Parameters (SFT III) 


Parameter 


Use to 





Notify All Users Of Mirrored Server 
Synchronization = value 


Server Failure Notification Name = 
name 





378 Utilities Reference 


Specify whether to broadcast a message to all logged-in users 
when the mirrored servers begin synchronizing. If the SFT III 
server:notifying users of synchronizationserver has more than 
64 MB of RAM, or if server synchronization takes more than 5 
seconds, set this parameter to ON. 


Supported values : ON, OFF 
Default: OFF. 


Specify the user or group name to notify with a broadcast 
message in case of a server or disk SFT III server:failure, 
notifying about;Failure:notifying SFT Ill users aboutfailure or 
disk-out-of-sync condition. To send the broadcast to all logged- 
in users, use group EVERYONE. 


Note : If you use an invalid user or group name, the broadcast 
message will fail. 


Supported values : any valid user or group name. 
Default : no group or user name. 


SET 








Parameter 


Use to 





MSEngine Use Primary Server For 
DOS 1/0 for MSEngine, 
setting;MSEngine:DOS I/O, 
setting;Floppy drive input to 
MSEngine, settingDOS I/O = value 


Specify which server to use for DOS input to the MSEngine. To 
copy data from the secondary server’s DOS partition or floppy 
drive, set this parameter to OFF. 


Supported values : ON, OFF. 
Default: ON. 
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Table 2-2110Engine Communication Parameters (SFT III) 


Parameter 


Use to 





Check LAN Option = number 


Check LAN Extra Wait Time = time 


Use Diagnostic Responder to 
Validate LAN Functionality = value 
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Check the functionality of the LAN boards in the server and 
prevent loss of service to clients by providing early warning of 
LAN board problems. 


Supported values: 0 to 2. 

0 = Don't check the server LAN boards. 

1 = If a LAN board problem is detected, notify the server console 
but don’t restart the primary server. 

2 = If the secondary server's LAN boards are more functional, 
restart the primary server. 


Default: 2. 


Note: The secondary server uses the same value for this 
parameter as the primary server. 


Specify the additional time the server waits (5 seconds plus the 
value of this parameter) before taking the action specified in the 
Check LAN Option parameter. If traffic is heavy on your network, 
or if MAUs need more time to reset, increase this setting. 


Supported values: 0 seconds to 59.3 seconds. 
Default: 0. 


Specify whether to broadcast an IPX diagnostic request to verify 
that LAN boards are functional. If the SFT server is running 
standalone, or if the system isn’t detecting bad boards, set this 
parameter to ON. 


Supported values: ON, OFF. 


If you have a router that replicates broadcast, don’t set this 
parameter to ON or a flood of network traffic will result. 


If your SFT Ill server is the only server on the network, set this 
parameter to ON. 


Default: OFF. 


SET 





Table 2-221I0Engine Memory Parameters (SFT III) 


Parameter Use to 





Borrow Short Term Memory Ahead Specify the amount of memory the system keeps available for 
Amount = number processes that temporarily need extra memory. 


If you get an insufficient short-term memory error while running a 
module, set this parameter to a higher value and reload the 
module. 


Supported values: 0 to 100000 bytes. 
Default: 32768 bytes. 
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Table 2-2310Engine Mirrored Server Parameters (SFT III) 


Parameter 


Use to 





SFT3 Error Wait Time = time 


Secondary Take Over Wait Time= 
time 


Display Mirrored Server Too Many 
Hops Away Message= value 
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Adjust all SFT III wait time parameters. 


Supported values: 0.5 second to 10 seconds. 
Default: 3 seconds. 


Change this parameter only if the systems are experiencing 
multiple timeouts. 


Note: Multiple timeouts might indicate a problem in the system. 


Specify the number of seconds that the secondary server waits 

for an I’m alive packet from the primary server before taking over 
as the new primary server. (For more information, see I’m Alive 
Packet in Concepts .) 


Supported values: 0.5 second to 20 seconds. 
Default: 1 second. 


Set this time to be longer than the MSL Error Wait Time. (For 
more about related SET parameters, see “Related SFT III Wait 
Time Parameters” on page 375 ) 


If your network is connected to a busy internetwork and packets 
take longer to travel across it, increase the value of this 
parameter. 


Important: If the message This server should not have become 
the primary server because the primary server is still alive 
appears, increase the Secondary Take Over Wait Time by 0.5 
second or more. 


However, setting this parameter too high may cause workstations 
to time out while the servers are determining if a switchover is 
needed. 


Specify whether to display a warning message if the hops 
between the mirrored servers exceed the Maximum Pseudo Hop 
Count parameter. 


Supported values: ON, OFF. 
Default: ON. 


SET 





Parameter 





Use to 





Maximum Pseudo Hop Count= 
number 


Enable Pseudo Hop Count= value 


New End Address For Unclaimed 
Memory Block= number 


Specify the maximum number of hops that the primary server will 
advertise as its pseudo hop count. (For more information, see 
Pseudo hop count in Concepts .) 


Supported values: 1 to 8. 
Default: 4. 


If your SFT Ill servers are installed on different network segments, 
with several hops between them, you may need to specify a 
higher Maximum Pseudo Hop Count. 


Important: Increasing the pseudo hop count reduces the number 
of hops available to stations on the internetwork. 


The total hop count (the pseudo hop count plus the actual number 
of hops from the router to the MSEngine) between a station and 
server cannot exceed 16. 


If the actual number of hops between mirrored servers is greater 
than the value specified by this parameter, the primary server 
advertises only the Maximum Pseudo Hop Count. 


Specify whether the primary server advertises an artificially high 
hop count when it is mirrored to a secondary server on a different 
network segment. (For more information, see Pseudo hop count 
in Concepts .) 


Supported values: ON, OFF. 
Default: ON. 


Define the end of the MSEngine’s memory range. The IOEngine 
claims any memory blocks numbered after the New End Address. 


If your servers have unequal amounts of RAM, use this parameter 
to align the memory of the larger-RAM server with the memory of 
the smaller-RAM server. (See Responding to Secondary Server 
is Missing RAM Messages in Supervising the Network .) 


Note: Reducing the MSEngine’s memory too much (by setting a 
low New End Address number) might prevent volumes from 
mounting. 


Supported values: 2097152 to 1073741824 bytes. 
Default: highest memory installed in the server. 
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SET 








Parameter 


Use to 





New Start Address For Unclaimed 
Memory Block= number 


MSL Error Wait Time= time 


Comprehensive MSEngine 
Synchronization Check= value 
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Define the start of the MSEngine’s memory range. The lOEngine 
claims any memory blocks that fall before the New Start Address. 


Supported values: 2097152 to 1073741824 bytes. 
Default: 5242880 bytes. 


If the IOEngine is frequently borrowing memory from the 
MSEngine, set the New Start Address to a higher number to give 
the |OEngine more memory. 


Specify the number of seconds that the MSL driver waits for an 
acknowledgment of a sent packet before signaling that the other 
server or the MSL has failed. 


Supported values: 0.2 second to 4.4 seconds. 
Default: 0.8 second. 


If your servers are very busy (CPU utilization over 60%), use this 
parameter to give them more time to communicate. The value of 
this parameter should be less than the Secondary Take Over Wait 
Time parameter. 


Note: Changing the default on this parameter makes it take 
longer to determine that the other server has failed. 


Specify whether to do a comprehensive verification that both 
MSEngine outputs are the same. 


Supported values: ON, OFF. 
Default: OFF. 


Note: The OFF setting provides a faster, simpler check of 
MSEngine outputs. Though it reduces synchronization time, the 
OFF setting may increase the risk of undetected synchronization 
errors. 


SET 





Parameter 





Use to 





IPX Internet Down Wait Time= time 


Display IPX Route to Other Server= 
value 


MSL Deadlock Wait Time= time 


Specify how many seconds the server waits before concluding 
that the IPX internetwork is not delivering packets. 


Supported values: 0.5 second to 59.3 seconds. 
Default: 4 seconds. 


If you have a busy network or hardware reliability problems, use 
this parameter to allow more time for the server to get IPX 
packets. 


The value of this parameter should be more than the Secondary 
Take Over Wait Time, but less than the MSL Deadlock Wait Time. 


Specify whether to display the IPX route to the other server. This 
parameter is useful for troubleshooting internetwork problems. 


Supported values: ON, OFF. 
Default: OFF. 


The IPX route can show how efficient the network routing is by 
displaying the node numbers, the addresses, and the number of 
hops to the other server. 


Specify how many seconds the server waits before concluding 
that the MSL driver is deadlocked (receive packets are being held 
off indefinitely). 


Supported values: 1 second to 59.3 seconds. 
Default: 5 seconds. 


If you have very busy servers, use this parameter to allow more 
time for the two servers to communicate. This setting times 4 is 
the time-out value that determines when the server exercises the 
MSL Send Blocked Recovery Option. 


Note: If you increase the IPX Internet Down Wait Time, you must 
also increase the MSL Deadlock Wait Time. Otherwise, if the MSL 
is deadlocked, the IPX connection may time out before the 
deadlock is detected. 


It is best if the MSL Deadlock Wait Time is at least one second 
longer than the IPX Internet Down Wait Time. 
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SET 








Parameter 


Use to 





Extra MSL Checking= value 


IOEngine Error Log Use DOS= value 


Always Down Server When Power 
Fails= value 


Turbo Memory Sync=value 
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Specify whether to do extra checking of MSL messages to ensure 
data integrity. 


Supported values: ON, OFF. 
Default: ON. 


Note: Setting this parameter to OFF may improve performance, 
but it increases the risk of undetected MSL errors. 


Specify whether to log system alerts to the default DOS drive if 
volume SYS: is not mounted. 


Supported values: ON, OFF. 
Default: ON. 


When the servers are resynchronized, the DOS error log is 
appended to the IO$LOG.ERR file on volume SYS:. 


Specify whether the MSEngine is shut down when a power failure 
is detected. 


Supported parameters: ON, OFF. 
Default: ON. 


Set this parameter to OFF to allow for continued service when 
both SFT Ill servers are on separate UPS devices. 


If the servers are fully synchronized and mirrored, and this 
parameter is set to OFF, the UPS halts only the |OEngine (rather 
than shutting down the MSEngine) when power fails. 


If only one of your SFT Ill servers has a UPS installed, leave this 
parameter set to ON. 


Change how the memory is synchronized on the server. 


Supported values: 

0 = Disable. 

1 = Enable and clear the memory. 

2 = Enable, but don’t clear the memory. 
Default: 2. 


The default gives you the best performance. Use the other 
methods only when instructed in troubleshooting. 


SET 





Don't change the settings for the parameters in Table 2-24 unless you are 
running SFT Ill in a testing environment. 
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Table 2-2410Engine Mirrored Servers Error Recovery Options Parameters (SFTIII) 


Parameter 


Use to 





Secondary Server MSL Send 
Blocked Recovery Option= option 


Primary Server MSL Send Blocked 
Recovery Option= option 


MSEngine Abend And Processor 
Exception Recovery Option= option 


Always Halt Secondary If Sync Error= 
value 
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Specify the recovery strategy for the secondary server if it detects 
that the MSL driver is not sending data to the other server at the 
correct rate. 


Supported options: 

0 = Halt the secondary server. 

1 = Halt the primary and secondary servers. 
2 = Restart the secondary server. 


Default: 2. 


Specify the recovery strategy for the primary server if it detects 
that the MSL driver is not sending data to the other server at the 
correct rate. 


Supported options: 

0 = Halt the secondary server. 

1 = Halt the primary and secondary servers. 
2 = Restart the secondary server. 


Default: 2. 


Specify the recovery strategy for the server that detects 
MSEngine software abends and MSEngine hardware exceptions. 


Supported options: 
0 = Halt the server. 
1 = Restart the server. 


Default: 1. 


Specify whether to halt the secondary server every time an error 
is detected during mirrored server synchronization. 


Supported values: ON, OFF. 
Default: OFF. 


SET 








Parameter 


Use to 





IOEngine Abend And Processor 
Exception Recovery Option= option 


Machine Check Recovery Option= 
option 


Memory Parity Error Recovery 
Option= option 


Secondary Server MSL Hardware 
Failure Recovery Option= option 


Specify the recovery strategy for the server that detects IOEngine 
software abends and IOEngine hardware exceptions. 


Supported options: 
0 = Halt the server. 
1 = Restart the server. 


Default: 1. 


Specify the recovery strategy for the server that detects hardware 
errors (other than memory parity errors). 


Supported options: 
0 = Halt the server. 
1 = Restart the server. 


Default: 1. 


Specify the recovery strategy for the server that detects memory 
parity errors. 


Supported options: 
0 = Halt the server. 
1 = Restart the server. 


Default: 1. 


Specify the recovery strategy for the secondary server detecting 
an MSL hardware failure. 


Supported options: 

0 = Halt the secondary server. 

1 = Halt the primary and secondary servers. 

2 = Restart the secondary server using the same MSL. 

3 = Restart the secondary server using the alternate MSL. 


Default: 2. 


The secondary server performs the set option unless the primary 
server has failed. If the primary server has failed, the secondary 
server becomes the new primary server. 
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Parameter 


Use to 





Primary Server MSL Hardware 
Failure Recovery Option= option 


MSEngine Outputs Different 
Recovery Option= option 


Secondary Server MSL Consistency 
Error Recovery Option= option 


Specify the recovery strategy for the primary server detecting an 
MSL hardware failure. 


Supported options: 

0 = Halt the secondary server. 

1 = Halt the primary and secondary servers. 

2 = Restart the secondary server using the same MSL. 

3 = Restart the secondary server using the alternate MSL. 


Default: 2. 


Specify the recovery strategy for the secondary server detecting 
that its MSEngine outputs are different from the primary server's 
MSEngine outputs. 


Supported options: 

0 = Halt the secondary server. 

1 = Halt the primary and secondary servers. 
2 = Restart the secondary server 


Default: 0. 


Specify the recovery strategy for the secondary server detecting 
communications consistency errors, such as checksum errors, 
invalid sequence number, or invalid packet type. 


Supported options: 

0 = Halt the secondary server. 

1 = Halt the primary and secondary servers. 

2 = Restart the secondary server using the same MSL. 

3 = Restart the secondary server using the alternate MSL. 


Default: 2. 


The secondary server performs the set option unless the primary 
server has failed. If the primary server has failed, the secondary 
server becomes the new primary server. 
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SET 








Parameter 


Use to 





Primary Server MSL Consistency 
Error Recovery Option = option 


Secondary Server MSL Deadlock 
Recovery Option = option 


Primary Server MSL Deadlock 
Recovery Option = option 


Specify the recovery strategy for the primary server detecting 
communications consistency errors, such as checksum errors, 
invalid sequence number, or invalid packet type. 


Supported options: 

0 = Halt the secondary server. 

1 = Halt the primary and secondary servers. 

2 = Restart the secondary server using the same MSL. 

3 = Restart the secondary server using the alternate MSL. 


Default: 2. 


Specify the recovery strategy for the secondary server detecting 
an MSL communications delivery deadlock. 


Supported options: 

0 = Halt the secondary server. 

1 = Halt the primary and secondary servers. 
2 = Restart the secondary server 


Default: 2. 


Specify the recovery strategy for the primary server detecting an 
MSL communications delivery deadlock. 


Supported options: 

0 = Halt the secondary server. 

1 = Halt the primary and secondary servers. 
2 = Restart the secondary server 


Default: 2. 





Don't change the settings for the parameters in Table 2-25 unless you are 
running SFT Ill in a testing environment. 
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Table 2-2510Engine Mirrored Servers Test Options Parameters (SFTIII) 


Parameter 


Use to 





Test Mode = option 


Stop On Server Test Unexpected 
Error = value 


Restart Minimum Delay Amount = 
time 
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Test server switchover and recovery with four failure scenarios. 


Supported options: 

0 = Dont initiate Test Mode. 

1 = Enable a simple halt/restart server test. 
2 = Generate MSL errors. 

3 = Generate system errors. 

4 = Generate errors of types 1, 2, and 3. 


Default: 0. 


Note: When you change the Test Mode setting back to 0, all settings 
for Mirrored Servers Error Recovery Options return to their defaults 


Suggestion: Because Test Mode options apply only to the primary 
server, you can set different test options in each server’s 
IOSTART.NCF file. For best performance, however, set the same 
test options in each server's IOSTART.NCF file. 


Specify whether to stop both servers if an unexpected error (not 
generated by the Test Mode) occurs. 


Supported values: ON, OFF. 
Default: ON. 


Specify how many seconds the server waits before executing a 
restart in Test Mode. 


Supported times: 0 seconds to 23 hours 43 minutes 40.1 seconds. 
Default: 10 seconds. 


This setting is added to the random number generated by the Restart 
Maximum Random Delay Amount parameter to determine the actual 
delay amount. 


If you notice several communications deadlocks or initialization 
failures while running your servers in Test Mode, use this parameter 
to allow more time for the server to finish switchover before 
restarting. 


SET 











Parameter Use to 
Server Test Minimum Delay Specify how many seconds the server waits before initiating the Test 
Amount = time Mode option. 


Supported times: 0 seconds to 23 hours 43 minutes 40.1 seconds. 
Default: 3 minutes. 


This setting is added to the random number generated by the Server 
Test Maximum Random Delay Amount parameter to determine the 
actual delay amount. 


Use this parameter to reduce the number of workstation pauses 
caused by frequent server resynchronization while running in Server 


Test Mode. 
Restart Maximum Random Delay Specify the maximum random number that the server generates to 
Amount = time add to the Restart Minimum Delay Amount. The resulting sum is the 
number of seconds the server waits before executing a restart in Test 
Mode. 


Supported times: 0 seconds to 59 minutes 19.2 seconds. 
Default: 0 seconds. 


Server Test Maximum Random Specify the maximum random number that the server generates to 

Delay Amount = time add to the Server Test Minimum Delay Amount. The resulting sum is 
the number of seconds the server waits before initiating the Test 
Mode option. 


Supported times: 0 seconds to 59 minutes 19.2 seconds. 
Default: 19.8 seconds. 
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Table 2-2610Engine Error Handling Parameters (SFT III) 


Parameter Use to 





Status Dump File State = number Specify the action to take if the MSSTATUS.DMP file size exceeds 
the size limit. 


Supported values: 

0 = Take no action if the file grows too large. 
1 = Delete the log file if it grows too large. 

2 = Rename the log file if it grows too large. 


Default: 1. 
IOEngine Error Log File State = Specify the action to take if the IO$¢_LOG.ERR file size exceeds the 
number size limit. 


Supported values: 

0 = Take no action if the file grows too large. 
1 = Delete the log file if it grows too large. 

2 = Rename the log file if it grows too large. 


Default: 1. 


Status Dump File Overflow Size = Specify the size limit for the MSSTATUS.DMP file. 


number 
Supported values: 65536 to 4294967295 bytes. 


Default: 4194304 bytes. 


IOEngine Error Log File Overflow Specify the size limit for the IO$SLOG.ERR file. 


Size = number 
Supported values: 65536 to 4294967295 bytes. 


Default: 4194304 bytes. 


Additional Information 


Topic See 





Using SERVMAN to change “SERVMAN” 
set parameters 


Controlling file compression Using SET to Control File Compression in 
Supervising the Network . 


394 Utilities Reference 


SET 





Topic 





See 





Improving server 
performance 


Editing .NCF files 


Time synchronization and 
the TIMESYNC.CFG file 


Improving Server Performance in Supervising 
the Network . 


Creating or Editing a Server Batch (.NCF) File 
in Supervising the Network . 


Maintaining Network Time Synchronization in 
Supervising the Network . 
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SET TIME 


Purpose 


Syntax 
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Use at the server console to set the date and time kept by the server. 


Setting the time incorrectly can adversely affect the performance of Novell 
Directory Services (NDS). 


Because time synchronization between servers is critical to NDS, make sure 
you understand time synchronization before you change the time or time zone 
on a server. (For more information, see Maintaining Network Time 
Synchronization in Supervising the Network .) 


SET TIME mo /day /yr hr :min :sec 





Parameter Use to 





mo /day lyr Specify the date. 
Use any of these formats for the date: 


9/28/98 
September 28, 1998 
28 September 1998 





SET TIME 





Using SET TIME 





Parameter Use to 





hr :min :sec Specify the time. 


Enter the time in either standard or 24-hour- 
clock format: 


1:15:32 p.m. (standard format) 
13:15:32 (24-hour-clock format) 


Separate hours, minutes, and seconds with 
colons. You can omit the minute and second 
entries, but you must include the colon after the 
hour. 


Specify a.m. or p.m. (for example, 7:14:32 AM). 
If you don't specify a.m. or p.m., NetWare 
assumes you are entering the time in 24-hour- 
clock format. 


For example, if you enter 1:00, the time is set to 
1:00 a.m. If you enter 13:00, the time is set to 
1:00 p.m. 





SET TIME is most appropriately used on a Reference or Single 
Reference time server. These types of time servers don’t change 
their time to converge with other servers, but supply the time for 
other servers. 


If you change the time on a Primary, Reference, or Single 
Reference time server, you will affect the time on all other servers 
that refer to that time server. (They will converge to the new time.) 


You can set both the date and the time in the same command or 
separately. You can enter either the date or the time first. If you 


replace only one variable, the other remains unaffected. 


The time display is formatted according to the server language 
standards. (For example, in the U.S. the format is 1:15:32 PM.) 
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SET TIME 





Examples 


To set the date and time on your server to December 19, 1998 at 2:15 PM, type 
SET TIME 12/19/98 2:15:00 PM 
or 


SET TIME DECEMBER 19, 1998 14:15:00 


Additional Information 
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Topic See 





Displaying the server's time “TIME” 


Setting the time zone “SET TIME ZONE” 
Network time Maintaining Network Time Synchronization in 
synchronization Supervising the Network . 


SET TIME ZONE 





SET TIME ZONE 


Purpose 


Syntax 


Use at the server console to configure time zone information. 


Because time synchronization between servers is critical to Novell Directory 
Services, make sure you understand time synchronization before you change 
the time or time zone on a server. (For more information, see Maintaining 
Network Time Synchronization in Supervising the Network . 


SET TIME ZONE zone 


Parameter 


[+|-] hr :min :sec [daylight ] 


Use to 





(no parameter) 


zone 


Display time zone setting. 


Specify a standard abbreviation for the name of 
the time zone. Examples: 


EST (Eastern Standard Time) 
CST (Central Standard Time) 
MST (Mountain Standard Time) 
PST (Pacific Standard Time) 


Specify the number of hours east or west of the 
Coordinated Universal Time (UTC) meridian. 


Note: UTC has been known historically as 
Greenwich Mean Time or GMT. 


Use + (plus) to set time zones west of UTC. 


Use — (minus) to set time zones east of UTC. (If 
you don’t enter this parameter, the default is +.) 
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Parameter 


Use to 





hr :min :sec 


daylight 


Using SET TIME ZONE 


Specify the time difference between UTC and 
the local time zone. You can specify this 
difference simply in hours. Or, for extreme 
accuracy, specify hours, minutes and seconds. 


Examples: 


EST is 5 hours west of UTC; CST is 6 hours 
west; MST is 7 hours west; PST is 8 hours 
west. 


Specify the standard abbreviation for the time 
zone during Daylight Saving Time (DST). 


Don't enter this abbreviation if you don't 
observe DST. 


Examples: 


EDT 
CDT 
MDT 
PDT 


~ 


Eastern Daylight Time) 
Central Daylight Time) 
Mountain Daylight Time) 
Pacific Daylight Time) 


ao oO 


Important: This parameter does not turn on 
Daylight Saving Time. You turn on Daylight 
Saving Time (and configure related 
parameters) by using the SET command. 


@ Time zone information is critical to time synchronization for 
Novell Directory Services. Additionally, time zone information is 
provided to modules that make calls to CLIB and related modules. 


@ You specify the abbreviation the operating system uses for 
daylight saving time with the SET TIME ZONE daylight 
parameter. You turn on daylight saving time and set the start and 
end date with the SET command. 


@ Ifyou don’ set the time zone, there are no standard abbreviations 
and the time zone offset is zero. 
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SET TIME ZONE 





Examples 
@ To display the time zone setting, type 
SET TIME ZONE 
@ To set the time zone to mountain standard time, type 


SET TIME ZONE MST7 


(This example applies to an area that doesn’t observe daylight 
saving time.) 


@  Toset the time zone to Pacific standard time and set the 
abbreviation for daylight saving time, type 


SET TIME ZONE PST8PDT 


(When daylight saving time is active, PST will be known as PDT.) 
+ To set the time zone for Germany (Mid-European Time), type 


SET TIME ZONE MET-1 


The -1 sets the time zone 1 hour ahead of UTC, since Germany is 
1 hour east of the UTC meridian. 


Additional Information 





Topic See 





Displaying the server's time “TIME” 
Setting the server's time “SET TIME” 


Turning on daylight saving “SET” 
time and setting related 


parameters 
Network time Maintaining Network Time Synchronization in 
synchronization Supervising the Network . 
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SETPASS 


Purpose 


Syntax 


Examples 
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Use at a workstation to change a user’s password. 


SETPASS [servername /] [username ] [/? | /VER] 


Parameter 


Use to 





(no parameter) 


servername / 


username 


/? 


/VER 


Change your password on the network. 


Replace with the name of the server where you 
want to change the user’s password. 


Replace with the name of the user whose 
password you want to change. 


View online help. All other parameters are 
ignored when /? is used. 


View the version number of the utility and the 
list of files it uses to execute. All other 
parameters are ignored when /VER is used. 


@ To change your password on the network, type 


SETPASS 


@ To change user BARNEY’s password (if you have rights), type 


SETPASS BARNEY 


@ To change user JAY’s password on server HACKER, type 


SETPASS HACKER/JAY 


SETPASS 





@ To change your password on server FRIENDLY, type 


SETPASS FRIENDLY/ 
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SETTTS 





Purpose 
Use at a workstation to 
@ Set the logical record locks for the Transaction Tracking System 
(TTS) 
@ Set the physical record locks for TTS 
@ View the logical and physical locks for TTS 
Syntax 


SETTTS [logical level [physical level ] [/options 


Peres (i | 
[/? | /VER] 








Parameter Use to 

logical level Specify the logical number value you want to 
set. 

physical level Specify the physical number value you want to 
set. 

/? View online help. 

/option Replace option with any available option. See 


“SETTTS Options” 


/VER View the version number of the utility and the 
list of files needed to run the utility. 


Using SETTTS 


@ When you log out from or turn off your workstation, the settings 
are reset to 0. 
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SETTTS Options 


Examples 





@ TTS values are 0 to 254. The logical level and physical level values 
indicate how many record locks TTS will ignore before tracking 
the transaction. 

Setting the to 1 means that TTS tracks each transaction; setting it 
to 254 means that TTS ignores 253 record locks before it tracks. 

@ A value of 255 or /D disables a level. 

Option Use to 

/C Scroll continuously through the report of 

accounting charges. 

/N Set the logical and physical settings to 0. 

/D Disable the logical and physical settings. 

@ To seethe logical and physical settings, type 
SETTTS 

+ To reset both logical and physical settings to the default (0), type 
SETTTS /N 

@ To disable both logical and physical settings, type 
SETTTS /D 

@ To disable the logical level and set the physical level to 4, type 


SETTTS /D 4 
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Additional Information 


Topic See 





Transaction tracking Transaction Tracking System in Concepts. 
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SPEED 


Purpose 


Use at the server console to display the speed at which the processor is running. 


Syntax 


SPEED 


About Processor Speed 


@ Processor speed rating is determined by 
+ CPU clock speed (33 MHz, 50 MHz, 66 MHz, or 90 MHz) 
+ CPU type (80386, 80486, Pentium, etc.) 


+ Number of memory wait states (0, 1, 2, etc.) 


@ If your computer has a slower rating than you expected, use 
SPEED to check the CPU speed rating. 


An 80386 CPU running at 33 MHz should get a rating of about 320. 
An 80486 CPU running at 50 MHz should get a rating of about 
1370. A Pentium CPU running at 66 MHz should get a rating of 
about 3660. 


@ Some computers have an Auto or Common CPU speed mode that 
can reduce the clock speed to as little as 6 MHz. 


@ For NetWare 4 operation, the CPU should be set to the highest 
speed. If your machine has a slower rating than expected, check 
the CPU speed setting. 


See your computer’s documentation for instructions on how to set 
the CPU speed. 
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SPXCONFG 


Purpose 


Syntax 


SPXCONFG Options 
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Use at the server console to configure certain SPX™ parameters. 


These parameters can also be configured from the INETCFG utility. 


LOAD SPXCONFG [option [=value ]] 








Parameter Use to 

(no parameter) Load SPXCONFG and display configuration 
menu. 

option Replace option with any available option. See 
“SPXCONFG Options” 

value Specify a numerical value for an option. 


For information on setting these values, see 








“INETCFG” 
Option Use to 
A= Specify SPX Watchdog Abort timeout (in ticks). 
V= Specify SPX Watchdog Verify timeout (in ticks). 
W= Specify SPX Ack Wait timeout (in ticks). 
R= Specify SPX Default Retry count. 
S= Specify maximum concurrent SPX sessions. 





SPXCONFG 





Using SPXCONFG 





Option Use to 





Specify quiet mode (suppresses display of 
changed settings). 


Display SPXCOMFG help screen. 


Specify IPX maximum socket table size. 


You can use SPXCONFG in your AUTOEXEC.NCF file, as a 
console command, as a menu utility, or as a configuration file that 
is invoked by INETCFG. 


If you don't specify a parameter, the following menu appears: 


SPX Configuration Control Program 
SPX Watchdog Abort timeout 540 
SPX Watchdog Verify timeout 54 
SPX Ack wait timeout 108 

SPX Default Retry count 10 


. Maximum concurrent SPX sessions 2048 


Nn OF WN FP 


IPX maximum socket table size 1200 


You can then select parameters to change. 


SPXCONIG changes the configuration of SPX as well as the 
STREAMS-based SPXS (SPXII). 


If you enabled TCP/IP on the server, you can use either INETCFG 
or SPXCONFG to set SPX parameters. 


When you set the parameters using INETCFG, a load line for 
SPXCONFG is automatically added to the NETINFO.CFG file so 
it runs each time you bring up the server. 


If you have only IPX/SPX enabled on the server (and not TCP/IP) 
and you want to use the SPXCONFG parameters each time you 
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SPXCONFG 





boot the server, place the following command in your 
AUTOEXEC.NCF file: 


LOAD [path ]SPXCONFG [option [=value ]] 


Examples 


To set SPX options to 1000 ticks for the SPX Watchdog Abort timeout and 
suppress the display of changed settings, type 


LOAD SPXCONFG A=1000 Q=1 


Additional Information 





Topic See 





Setting parameters in an Creating or Editing a Server Batch (.NCF) File 


.NCF file in Supervising the Network. 
Setting SPX parameters “INETCFG” 
with INETCFG 
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SPXS 





Purpose 
Use at the server console to provide STREAMS-based SPX protocol services. 
Syntax 
LOAD [path ]SPXS [LDFILE = [path ]filename [ext ]] 
Parameter Use to 
path Specify the path to SPXS if you moved it from 
the default directory. 
LDFILE = [path ]\filename Load the data file that contains the SPX timer 
[.ext] defaults and physical packet size tables. 
If you don’t specify a filename, SPXS sets the 
parameters defined in the IPXSPX.CFG file. 
If you don't specify a file extension, the default 
is .CFG. 
Using SPXS 


@ When you load SPXS, the parameters in the IPXSPX.CFG file are 
set, unless you specify an alternate configuration filename. 


The IPXSPX.CFG file is modified from the INETCFG utility when you set SPX/ 
IPX parameters. 


@ You can create multiple configuration files in addition to 
IPXSPX.CFG. Use this feature if you frequently alternate between 
two or more IPX/SPX configurations. 


To create multiple configuration files, copy the IPXSPX.CFG file to 
a new filename (IPXSPX2.CFG, for example). Then you can 
change the IPXSPX.CFG file (by using INETCFG) and still 
preserve the original configuration in the IPXSPX2.CFG file. 
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@ To load a configuration file other than the default IPXSPX.CFG 
file, use the LDFILE option. 


For example, if you have a second configuration file called 
IPXSPX2.CFG, you can load that configuration by typing 


LOAD SPXS LDFILE = IPXSPX2 


@ When you load SPXS, STREAMS is autoloaded. 


Additional Information 





Topic See 





Setting SPX parameters “SPXCONFG” 
using SPXCONFG 


Setting parameters in an Creating or Editing a Server Batch (.NCF) File 
.NCF file in Supervising the Network . 


Setting SPX parameters “INETCFG” 
using INETCFG 





412 Utilities Reference 


STREAMS 





STREAMS 


Purpose 


Syntax 


Using STREAMS 


Use at the server console with a loadable module that requires the CLIB-related 
modules or uses STREAMS-based protocol services. 


Normally, you won't need to load STREAMS because it is autoloaded by other 
modules when needed. 


LOAD [path ] STREAMS [MAX MESSAGE SIZE = n ] 





Parameter Use to 





path Specify the path to STREAMS if you moved it 
from the default directory. 


MAX MESSAGE SIZE =n Specify the maximum message size in bytes. 
This value can be between 4,096 and 65,535 
bytes. The default is 8,192 bytes. 





@ STREAMS will not load unless CLIB and its related modules are 
loaded. When these modules load, they autoload STREAMS. 


© Increasing maximum message size can improve the performance 
of some protocol stacks. 


@  IfSTREAMS is autoloaded, the default value for MAX MESSAGE 
SIZE is used. To change this size, unload STREAMS and load 
again, specifying a new MAX MESSAGE SIZE value. 


@ Both SPX II and AppleTalk Filing Protocol (AFP) can use a larger 
maximum message size. 
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SPX Il is an improved version of SPX that yields better performance with some 
applications. STREAMS uses SPX II. 


@ Don’t set maximum message size higher than 16K. The 


performance benefit gained doesn’t compensate for the extra 
server memory consumed by the protocol stacks. 


Additional Information 





Topic See 





CLIB modules “CLIB” 
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SYSTIME 





Purpose 
Use at a workstation to synchronize the date and time set on your station with 
those of the server. 

Syntax 
SYSTIME [server name ] [/? | /VER] 

Parameters Use to 

server name Specify the name of the server that you want to 
synchronize your workstation with. 

/? View online help. All other parameters are 
ignored when /? is used. 

/VER View the version number of the utility and the 
list of files it uses to execute. All other 
parameters are ignored when /VER is used. 

Examples 


@ = Tosynchronize your workstation’s date and time with those of the 
default server, type 


SYSTIME 


@ To synchronize your workstation’s date and time with those of 
server SCOTTY, type 


SYSTIME SCOTTY 


@ To synchronize your workstation’s date and time with those of 
server FISHBONE in the context NOVELL.US, type 


SYSTIME .FISHBONE .NOVELL.US 
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Additional Information 


Topic See 





Synchronization Time Synchronization in Concepts . 
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TCPCON 


Purpose 


Syntax 


Using TCPCON 


Use at the server console to 


+ 


Monitor activity in the TCP/IP network segments of your 
internetwork 


View configuration and statistics information about the following 
TCP/IP protocols: IP, ICMP, UDP, TCP, OSPF, and EGP 


View IP routes known to a TCP/IP node 

View network interfaces supported by a TCP/IP node 

Access the trap log maintained by SNMPLOG (local systems only) 
Use Simple Network Management Protocol (SNMP) over TCP/IP 


or IPX to access TCP/IP information in any remote protocol stack 
supporting the TCP/IP Management Information Base (MIB) 


LOAD TCPCON 


By default, TCPCON monitors and gathers information from the 
local NetWare TCP/IP node. 


You can, however, access another TCP/IP node on your 
internetwork if you know the symbolic hostname or host IP 
address of that node. 


When you load TCPCON, the TCPCON main screen appears: 
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| TCP/IP Console 3.00 





Host: Local System 
Uptime: 0 Days 18 Hours 12 Min 
System: Novell NetWare v3.11 < 


IP Received: 3 
IP Sent: 4 


@ The top of the main screen displays a summary of statistics for the 
selected host, as follows: 





Field Explanation 





Host Symbolic host name or IP address of the 
selected TCP/IP host (or server name if 
accessing a remote node using IPX) being 
queried. This is the host specified in SNMP 
Access Configuration in the Available Options 
menu. 


Uptime Amount of time that has elapsed since the 
selected host was last initialized. 


System Brief description of the selected host. 


IP Received Number of IP datagrams received from all 
interfaces, including those received in error. 


IP Sent Number of datagrams sent to IP for 
transmission. This number does not include 
datagrams forwarded by this host. 


IP Forwarded Number of IP packets forwarded from one 
node to another. This field displays the value 
Disabled if this host is not configured to be an 
IP router. 
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Field 





Explanation 





TCP Received 


TCP Sent 


TCP Connections 


Number of TCP segments received, including 
those received in error. 


Number of TCP segments sent, excluding 
those containing retransmitted data. 


Number of currently established TCP 
connections. 


@ The Available Options menu on the main screen allows access to 
additional features of TCPCON, as follows: 





Option Use to 
SNMP Access View and modify TCPCON options. 
Configuration 


Protocol Information 
IP Routing Table 
Statistics 


Interfaces 


Display Local Traps 


View protocol information for the selected host. 
View IP routers known to the selected host. 
View TCP/IP statistics. 


View the network interfaces supported by the 
selected host. 


View the local SNMP trap log maintained by 
SNMPLOG.NLM. 
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TECHWALK 





Purpose 


Use at the server console to record NetWare configuration information. 


Syntax 


LOAD TECHWALK [console_NLM_name] 


Parameter Use to 





(no parameter) Record configuration information for 
the NetWare MultiProtocol Router 3.1 
INETCFG NLM program. 


console_NLM_name Record configuration information for 
the specified NLM program. 


Using TECHWALK 


TECHWALK saves the configuration information for INETCFG (or the 
specified NLM program) to a file named SYS:ETC\TECHWALK.OUT. All 


enabled items and summary lists are recorded. 


You might prefer to exit INETCFG (or the specified NLM program) before you 
run TECHWALK. Running TECHWALK takes from 5 to 60 minutes, 
depending on your configuration and the network traffic, and dedicates your 
machine to the process during that period. 
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THREADS 


Purpose 
THREADS.NLM is a library of functions that constitute the threads package 
for NetWare 4. You don’t need to load THREADS .NLM; it’s autoloaded by any 


module that needs it. 


See “CLIB” for more information. 
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TIME 


Purpose 

Use at the server console to display 

@ Date and time kept by the NetWare server's clock 

@ Daylight-saving-time status 

@ = Time synchronization information 
Syntax 

TIME 
Using TIME 

@ When you execute TIME, information similar to the following 

appears on the console screen: 

The output is formatted according to your locale configuration. 
Figure 2-20 
TIME Output 


SALES : time 
Time zone string: “MST?MDT" 
DST status: OFF 
DST start: Sunday, April 4, 1993 2:00:00 am MST 
DST end: Sunday, October 31, 1993 2:00:00 am MDT 
Time synchronization is active. 
Time is synchronized to the network. 

Monday, June 11, 1993 7:06:59 pm UTC 

Monday, June 11, 1993 12:06:59 pm MST 


@ To reset the server’s date or time, use SET TIME. 
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Additional Information 


Topic 


See 





Setting the server's time 
Setting the time zone 


Network time 
synchronization 


“SET TIME” 
“SET TIME ZONE” 


Maintaining Network Time Synchronization in 
Supervising the Network . 
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TIMESYNC 


Purpose 


Syntax 


Use at the server console to monitor the internal time on a server to ensure that 
the time reported by all servers across the network is consistent, or 
synchronized. 


TIMES YNC autoloads when the server boots. Under very few circumstances 
will you ever load or unload TIMESYNC. You may, however, want to load 
TIMES YNC to use an alternate configuration (.CFG) file. 


LOAD [path ]TIMESYNC 


Parameter Use to 





path Specify the path to TIMESYNC.NLM if you 
moved it from the default directory. 





You can set TIMES YNC parameters in the configuration file 
(TIMES YNC.CFG) or with the SET and SERVMAN utilities). 


Additional Information 
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Topic See 





Setting time synchronization “Time Synchronization Parameters” in SET 
parameters 


Managing network time Maintaining Network Time Synchronization in 
synchronization Supervising the Network 





TLI 





TLI 








Purpose 
Use at the server console to provide Transport Level Interface (TLD 
communication services. 
Syntax 
LOAD [path ]TLI 
Parameter Use to 
path Specify the path to TLI.NLM if you moved it 
from the default directory. 
Using TLI 


+ To use TLI, you must have one or more protocol service modules 
loaded, such as SPXS or IPXS. 


@ TLlialso requires STREAMS, CLIB, and CLIB-related modules and 
autoloads them if they are not already loaded. 
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TPING 


Purpose 


Syntax 


Using TPING 
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Use at the server console to send an Internet Control Message Protocol (ICMP) 
echo request packet to an IP node on your internetwork. 


TPING is a command line utility that determines whether an IP target node on 
your internetwork is reachable. 


LOAD TPING host [packet size [retry count ]] 


Parameter Use to 





host Specify the symbolic host name or IP address 
of a TCP/IP system on the network. 


packet size Specify the size, in bytes, of the ICMP packet. 
retry count Specify the number of times you want to 


resend an ICMP packet to the host system if a 
reply is not received (default = 5). 





TPING sends an ICMP echo request packet to the IP target node. If the target 
node receives the request packet, it sends back a reply packet. 


If TPING doesn’ receive a reply, it resends the request packet the specified 
number of times. 


When TPING receives a reply, it stops sending requests and displays a message 
indicating that the target node is reachable. (If it doesn’t receive a reply, TPING 
also notifies you.) 


TRACK OFF 





TRACK OFF 


Purpose 
Use at the server console to prevent the server from displaying the RIP 
Tracking Screen. This screen displays Router Information Protocol (RIP) 
traffic on the server. 

Syntax 


TRACK OFF 


Additional Information 


Topic See 





RIP Tracking Screen “TRACK ON” 
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TRACK ON 


Purpose 


Syntax 


Using TRACK ON 


Incoming Information 


428 Utilities Reference 


Use at the server console to view the RIP Tracking Screen and make it the 
active screen. This screen displays Router Information Protocol (RIP) traffic on 
the server. 


TRACK ON 


@ TRACK ON signals the router to display all server and network 
routing (RIP) packets that are received or sent. 


@ TRACK ON displays information about servers, networks, and 
connection requests. 


This information is formatted according to whether the NetWare 
server is 


+ Receiving incoming information (IN) 
+ Broadcasting outgoing information (OUT) 


+e Receiving a connection request 


Incoming information looks similar to the following: 


IN [00D0C200:00001B026C09] 10:53:0lam 010123C5 11/22 
5300DEEF 3/4 00001EF0 5/365 


FADE2401 12/98 00001EEE 2/3 C9008617 5/11 






































The packet is incoming from network address 00D0C200 and from the server 
at node address 0001B026C09. The packet was sent at 10:53 am. 


TRACK ON 





Outgoing Information 


Connection Request 


The columns of data that follow the line labeled IN are network numbers that 
the sending server knows about. For example, 010123CS5 and 5300DEEF are 
the network numbers recognized by the server at address 00001B026C09 


The numbers 11/22 and 3/4 indicate routing information about that network. 
For example, the 11/ and 3/ indicate the hop count, or number of hops 
(gateways or routers) from the sending server to this network. 

The maximum number of hops a RIP packet travels is 16. 


The /22 and /4 indicate the number of ticks (1/18th of a second) that a packet 
took to reach this network from the sending server. 


Outgoing information looks similar to the following: 


OUT [1986DAD0:8941A801] 11:00:0lam 
OOOO1LEEE 2/3 5300DEEF 3/4 OOOO1EFO 5/365 
FADE2401 2/3 FEEDOOBB 4/5 ACCCDDD 5/11 


















































The packet is outgoing from network address 1986DAD0 and from the server 
at node address 8941A801. The packet was sent at 11:00 am. 


The columns of data that follow the line labeled OUT are network numbers that 
the sending server knows about. The associated hop and tick count information 
is listed after each network. For an explanation of these, see “Incoming 
Information.” 


When a client boots and loads a NetWare Requester™ (such as DOS 
Requester), a Get Nearest Server request is broadcast on the network the station 
is cabled to. 


Any connected server can receive the message and respond to the station with 
a Give Nearest Server response. 


The station initially attaches to the first server that responds to the Get Nearest 
Server request. 
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Additional Information 
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Topic See 





Turning off the RIP Tracking 
Screen 


“TRACK OFF” 


Displaying advertised “DISPLAY NETWORKS” 


networks (SAP traffic) 


Displaying advertised 
servers (SAP traffic) 


“DISPLAY SERVERS” 


Resetting routers “RESET ROUTER” 


UIMPORT 





UIMPORT 


Purpose 


Use at a workstation to import user information from an existing database into 
the Novell Directory Services (NDS) database. 


Syntax 


UIMPORT [control file ] [data file ] [/C] [/? | /VER] 


Parameter 


Use to 





control file 


data file 


/C 


/? 


/VER 


Specify the name of the file that gives 
UIMPORT information on how to load user 
data into the directory. 


Specify the name of the ASCII file that contains 
attribute values. 


Scroll continuously through output. UIMPORT 
without /C will pause after outputting each 
page of information. 


View online help. All other parameters are 
ignored when /? is used. 


View the version number of the utility and the 
list of files it uses to execute. All other 
parameters are ignored when /VER is used. 
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UNBIND 


Purpose 


Syntax 


432 Utilities Reference 


Use at the server console to 


network board 


@ Remove a communication protocol from the LAN driver of a 


@ Disable communication on a specific board 





LAN_driver | board_name 


driver parameter 


UNBIND protocol [FROM] LAN_driver | board_name 
[[driver parameter... ]] 
Parameter Use to 
protocol Specify the name of the protocol you want to 


unbind. 


Specify the name of the LAN driver or the 
network board from which you are unbinding 
the protocol. 


Specify one or more driver parameters if you 
have more than one network board of the same 
type in your server. See “UNBIND Driver 
Parameters” 


Note: Enclose driver parameters in square 
brackets. 


UNBIND 





UNBIND Driver Parameters 


Driver parameter 


Use to 





[DMA=number] 


[FRAME=number | 


[INT=number] 


[MEM=number] 


[PORT=number] 


[SLOT=number] 


[NODE=number ] 


Using Driver Parameters 


Specify the DMA channel for the board. Use 
the same channel you did when you loaded the 
driver. 


Specify the frame type for the board. Use the 
same frame type you did when you loaded the 
driver. 


Specify the interrupt for the board. Use the 
same interrupt you did when you loaded the 
driver. 


Specify the memory address for the board. Use 
the same memory address you did when you 
loaded the driver. 


Specify the I/O port for the board. Use the 
same I/O port you did when you loaded the 
driver. 


Specify the network board by the slot that it 
was installed in. 


Use this parameter with microchannel and 
EISA computers. Use the same slot number 
you did when you loaded the driver. 


Specify the node number of the board. 


@ You must tell the operating system which network board or LAN 
driver to unbind the communication protocol from. 


+ Ifyou have multiple boards or LAN drivers, you must unbind 


each one separately. 
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@ = If your server has more than one instance of the LAN driver 
loaded, use one or more driver parameters to specify the 
particular board you are unbinding. 


@ To prevent a driver from binding automatically when the server 
boots, delete the following line from the AUTOEXEC.NCF file: 


BIND IPX TO LAN driver NET=number 


Examples 


@ = To unbind IPX from an NE3200 driver that has been loaded only 
once, type 


UNBIND IPX FROM NE3200 
@ To unbind IPX from an NE3200 driver that has been loaded more 
than once, using driver parameters to specify the particular 


network board, type 


UNBIND IPX FROM NE3200 [SLOT=3, 
FRAME=ETHERNET_IT] 


Additional Information 





Topic See 





Viewing a list of “PROTOCOL” 
communication protocols 
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UNICON 


Purpose 
Use at the server console to manage certain NetWare products installed on a 
server, such as the NetWare Domain Name System (DNS) and the NetWare/IP 
Domain SAP/RIP Service (DSS). 
You can perform the following tasks with the UNICON utility: 
@ Change to another server to configure and manage a different 
NetWare server running UNICON 
@ Configure the server's global parameters 
@ Start, stop, and monitor certain services 
@ Configure and manage NetWare DNS and DSS services 
@ Configure error reporting 
@ Monitor performance and adjust parameters affecting 
performance 
Syntax 


LOAD UNICON 


Using UNICON 


Initially, the utility displays the following login form with the Server Name and 
User Name fields filled in. 


Server Name: servername 





Username: .CN=admin.O=acme 
Password: 
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To access the UNICON utility, type the appropriate password in the Password 
field and press <Enter>. 


Additional Information 


Topic See 





Installing the NetWare/IP software Installing the NetWare/IP Software in 
NetWare/IP Administrator’s Guide . 


Using the UNICON utility Introducing UNICON and NWIPCFG 
in NetWare/IP Administrator’s Guide . 
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UNLOAD 


Purpose 


Syntax 


Use at the server console or a workstation running NetWare Client 32 software 
to 


@ Unload a module that was previously loaded with the LOAD 
command 


@ Unload old NLM files so that updated modules can be loaded 


UNLOAD NLM name 


Parameter Use to 





NLM_name Specify the module you want to unload. 


Before unloading a module, read the following section, Unloading Modules. 


Unloading Modules 


When you unload a module, all resources are returned to the system. 


Some modules will not unload because other modules depend on them. For 
example, STREAMS and MSM load automatically when they are needed by 
another module. 


Keep the following information in mind when unloading LAN drivers, name 
space modules, or disk drivers. 


@ LAN Drivers 


When you unload a LAN driver, the driver is unbound from all 
communication protocols and removed from all network boards it 
was linked to. 
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After a LAN driver is unloaded, users with network boards that 
require the unloaded driver receive the following error message: 





Network error on Server <fileserver>: Error 
receiving from network.Abort, Retry? 


If this occurs, do the following: 


+ Retry once to see if an alternate route to the NetWare server 
is available on another network. 


+ Ifthe retry fails, retry again after the LAN driver is reloaded 
and bound to the communication protocol. 


A user who receives the error message must reestablish a 
connection within 15 minutes. If the connection is broken for more 
than 15 minutes, the server watchdog terminates the station’s 
connection. 


If the LAN driver will be unloaded for 15 minutes or longer, have 
users log out before unloading the LAN driver. 


Name Space Modules 


Before unloading name space modules, dismount all volumes that 
are using the module. These volumes cannot be remounted until 
the module is loaded again. 


To permanently delete a name space from a volume before you 
unload the name space module, use VREPAIR. 


Disk Drivers 


Before unloading a disk driver, dismount all volumes stored on 
the hard disks connected to the controller or host bus adapter. 


If you don’t dismount the volumes, the system warns you that the 
driver is in use and lists the volumes using the driver. 


If you override the warning and unload the driver without 
dismounting the volumes, the server dismounts the volumes and 
notifies those who are using the volumes. 


UNLOAD 





Examples 
To unload MONITOR, type 


UNLOAD MONITOR 
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Purpose 
@ Provide the software link between your server and an 
uninterruptible power supply (UPS) attached to the server 
@ Activate UPS monitoring 
The UPS module does not use a serial port or AIO device driver. If you use a 
serial port or AIO device driver, you should use the UPS_AIO module. Refer to 
“UPS_AIO” 
Syntax 
LOAD [path ]UPS [parameter ...] 
Parameter Use to 
path Specify the path to UPS if you moved it from 
the default directory. 
TYPE=name Specify the name of the hardware interface for 
your UPS (DCB,STANDALONE, KEYCARD, 
MOUSE, other). 
Note: If you enter STANDALONE and itis not 
accepted, try KEYCARD. 
PORT=number Specify the hexadecimal number 


corresponding to the jumper setting on the 
board. Possible values for each type of board 
are: 


DCB: 346, 34E, 326, 32E, 386, 38E. 
Standalone: 240, 231 

Keycard: 230, 238. 

Mouse (no number required). 
Other (see board documentation). 
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Parameter 


Use to 





DISCHARGE = number 


RECHARGE = number 


WAIT = number 


Using UPS 


Specify an estimate of the number of minutes 
the server can operate on battery power before 
depleting the battery. (Consult the battery’s 
documentation.) 


Range: 1 to 3976821 minutes. 
Default: 20. 


Specify an estimate of the minutes the battery 
needs to fully charge. 


Range: 1 to 3976821 minutes. 
Default: 60. 


Specify the number of seconds you want the 
UPS to wait following a power interruption 
before being activated. 


Range: 1 to 300 seconds. 
Default: 15. 


@  Ifyouload UPS without parameters, the software prompts you for 


each parameter. 


@ As your UPS becomes older, you may need to decrease the 
discharge time or increase the recharge time. See “UPS TIME” for 


more information. 


@ Place the LOAD UPS command in your AUTOEXEC.NCF file to 
load it each time the server comes up. 
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Additional Information 


Topic See 





Adding an uninterruptible Activating UPS Monitoring in Supervising the 
power supply (UPS) Network . 
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UPS_AIlO 


Purpose 


Syntax 


If your uninterruptible power supply (UPS) is connected to the server through 
a serial port, use UPS_AIO to provide the software link between your server 


and the UPS. 


The UPS_AIO module uses a serial port and AIO device driver. If you use a 
different port or driver, you might need to use the UPS module. Refer to “UPS” 








LOAD [path ]UPS_AIO [parameter ...] 
Parameter Use to 
path Specify the path to UPS_AIO if you 


DOWNTIME=number 


moved it from the default directory 


Specify the amount of time to run on 
battery before system shutdown. If 
power is restored before this time 
elapses, no shutdown will occur. If a 
low battery condition occurs before 
this time elapses, an immediate 
shutdown will occur. 


Supported values: 30 seconds 
minimum, no practical maximum limit. 


Default: 300 seconds. 
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Parameter 





Use to 





MSGDELAY=number 


MSGINTERVAL=number 


DRIVERTYPE=number 


Specify the elapsed time before a 
broadcast message is first sent to 
users. 


Supported values: 0 seconds 
minimum, no practical maximum limit. 


Default: 5 seconds 


The broadcast message states the 
time remaining until shutdown. This 
message is created automatically by 
the UPS. 


Specify the time interval between 
broadcast messages sent to users. 


Supported values: 20 seconds 
minimum, no practical maximum limit 


Default: 30 seconds 


The broadcast message states the 
time remaining until shutdown. This 
message is created automatically by 
the UPS. 


Specify the AlO device driver type. 
Supported values: 1, 2, 3 
Default: 1 


The default value of 1 represents the 
AIOCOMX driver, which comes with 
NetWare. Other drivers may be 
represented by other driver type 
numbers. Refer to the documentation 
that came with the driver. 


UPS_AIO 





Parameter 





Use to 





BOARD=number 


PORT=number 


Specify the AIO board number. 


Supported values: Determined by 
the driver manufacturer. 


Default: 0. 


To determine the board number, read 
the driver information when the 
AIOCOM«xX driver is loaded. This 
information includes both the board 
and port numbers. 


If you do not use the AIOCOMX 
driver, refer to the driver 
documentation to determine the 
board number. 


Specify the port number. 


Supported values: Determined by 
the driver manufacturer. 


Default: 0. 


To determine the port number, read 
the driver information when the 
AIOCOM«xX driver is loaded. This 
information includes both the port and 
board numbers. 


If you do not use the AIOCOMX 
driver, refer to your driver 
documentation to determine the port 
number. 
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Parameter Use to 

SIGNAL_HIGH Specify the signal_high parameter to 
set the normal RS232 signaling state 
to high. 


Supported values: SIGNAL_HIGH 
or no value. 


Use this parameter only if your UPS 
system uses high values, instead of 
low values, to determine if power is off 
or the battery is low. Most UPS 
systems use low values. Refer to your 
UPS hardware documentation to 
determine whether you need to use 
the parameter. 


? Display a help screen that explains 
the other parameters. When you use 
this parameter, the UPS_AIO module 
is not loaded. To load UPS_AIO, you 
must execute LOAD UPS_AIO again, 
without the ? parameter. 





Using UPS_AIO 


The serial cable between the UPS and the server must be designed for use with 
the UPS. Contact the manufacturer of your UPS for information on the correct 
cable to use for your system. 


@ You must load an AIO device driver before loading UPS_AIO; the 
driver is not loaded automatically. The AIOCOMX driver is 
included with the NetWare operating system. If you want to use a 
different driver, consult the UPS hardware and driver 
documentation. 


@ The UPS_AIO module does not provide the same options as the 
UPS module. For example, UPS_AIO does not allow you to 
change parameter settings after loading the module. To change 
the settings, you must reload the module with the new parameter 
values. 
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UPS_AIO 





@ Place the commands to load the device driver and UPS_AIO in 
your AUTOEXEC.NCF file to load them each time the server 
comes up. 


@ After you load UPS_AIO, a status screen displays messages about 
the current status and activities of the UPS. To toggle between this 


and other screens, press <Alt>+<Esc>. These messages are also 
logged to SYS:SYSTEM\SYS$LOG.ERR. 


Additional Information 


Topic See 





Adding an uninterruptible Activating UPS Monitoring in Supervising the 
power supply (UPS) Network . 
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UPS STATUS 


Purpose 
Use at the server console to view information about the uninterruptible power 
supply (UPS) attached to the NetWare server. 
Use this command only if you loaded the UPS module to run your uninterruptible 
power supply. If you loaded the UPS_AIO module, see “UPS_AIO” for 
information about that module. 

Syntax 


UPS STATUS 


Using UPS STATUS 


@ This command is valid only if the UPS module is loaded and 
either the type is specified or the UPS adapter driver module is 
loaded. 


If the UPS module has not been loaded, the error message ??? 
Unknown command??? is displayed when you try to execute UPS 
STATUS. 


@ When UPS STATUS is executed, information similar to the 
following appears: 
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UPS STATUS 


Figure 2-21 
UPS STATUS screen 
Uninterruptible Power Supply 
Type: DCB 
Power being used: Commercial 
Discharge time requested: 20 minutes 
Remaining: 20 minutes 
0 seconds 
Battery status: Charged 
Recharge time requested: 60 minutes 
Remaining: 0 minutes 
0 seconds 
Current server power status: Normal 
Wait time requested: 15 seconds 
Remaining: 15 seconds 
NOTICE: If your battery is over 6 months old, you may need to lower the 
discharge time. (Consult the uninterruptible power supply 
documentation for details.) 








The fields in the UPS STATUS display are explained in the following table. 





Screen Output Explanation 





UPS Type The type of hardware handling the UPS. This 
line shows the name of the module if there is 


not a recognizable UPS hardware type. 
Power being used Possible values: Commercial, Battery 


Discharge time requested / 
Remaining 


Discharge time requested: an estimate of the 
time that the network can run safely on battery 
power. 


Remaining: the safe time remaining if the 
network is on battery power. 


If the network is running on commercial power 
and the battery is charged, the two values are 
the same. 
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Screen Output 





Explanation 





Battery status 


Recharge time requested / 
Remaining 


Current server power status 


Wait time requested/ 
Remaining 


Possible values: Charged, Low, Being 
Charged. 


If the battery status is low, repair or replace the 
battery. 


Recharge time requested: an estimate of the 
time needed to charge the battery after it has 
been totally discharged. 


Remaining: an estimate of the time needed to 
charge the battery in its current state. 


If the network is running on commercial power, 
the time needed to charge the battery is 0 if the 
battery is fully charged. 


If the network is running on battery power, this 
number increases as the battery is discharged. 


Possible values are as follows: 
Normal: running on commercial power. 
Server down: running on battery power. 


Server going down in x minutes: running on 
battery power. Enough power is left to run the 
network for the indicated number of minutes. 


Wait time requested: the number of seconds 
the UPS waits before being activated after a 
power interruption. 


Remaining: the time left before the UPS is 
activated. 


If there has been no power interruption (the 
network is running on commercial power), the 
two values are the same 





UPS STATUS 





Additional Information 





Topic See 
Changing UPS time “UPS TIME” 
parameters 
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UPS TIME 


@ Change the amount of time you want to allow the server to 


@ Change the time you estimate the battery needs to charge fully 


@ Change the time interval between a power interruption and UPS 


Use this command only if you loaded the UPS module to run your uninterruptible 
power supply. If you loaded the UPS_AIO module, see “UPS_AIO” for 


Purpose 
Use at the server console to 
function on battery power 
activation 
information about that module. 
Syntax 


UPS TIME [parameter .. 


-] 





Parameter 


Use to 





DISCHARGE = number 


RECHARGE = number 
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Specify an estimate of the number of minutes 
the server can operate on battery power before 
depleting the battery. (Consult the battery's 
documentation.) 


Range: 1 to 3976821 minutes. 
Default: 20. 


Specify an estimate of the minutes the battery 
needs to fully charge. 


Range: 1 to 3976821 minutes. 
Default: 60. 


UPS TIME 





Using UPS TIME 


Examples 





Parameter Use to 





WAIT = number Specify the number of seconds you want the 


UPS to wait following a power interruption 
before being activated. 


Range: 1 to 300 seconds. 
Default: 15. 





The parameters described in the preceding table are identical to 
some of the parameters used when loading UPS.NLM. Use UPS 
TIME to change these parameters, or change them when you load 
UPS.NLM. 


If the UPS module has not been loaded, the error message ??? 
Unknown command??? is displayed when you try to execute UPS 


TIME. 


This command is valid only if the UPS module is loaded and 
either the type is specified or the UPS adapter driver is loaded. 


If you don't specify the parameters, you are prompted for them. 
As your UPS becomes older, you may need to decrease the 
discharge time or increase the recharge time. Use the UPS TIME 


command to change these values. 


Changes made with UPS TIME aren't reflected on the UPS status 
display until you run UPS STATUS or UPS TIME again. 


Changes made remain in effect until you bring down the server. 


To change the discharge time to 20 minutes and the recharge time to 120 
minutes, type 


UPS TIME DISCHARGE=20 RECHARGE=120 
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Additional Information 





Topic See 
Loading UPS “UPS” 
Viewing UPS status “UPS STATUS” 


information 
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VERSION 





VERSION 


Purpose 


Syntax 


Using VERSION 


Use at the server console to view the server’s version information, license 
information, and copyright notice. 


VERSION 


When you execute VERSION, a message similar to the following appears: 


Novell NetWare 4.2 10/1/98 

(c) Copyright 1983-1998 Novell Inc. 

All rights reserved. 

Patent Pending Novell Inc. 

Maximum number of License Connections: 1000 


Current License Chain: 


Serial Number Connections License Type Version 
XXXXXXXXX 1000 MAIN 4.1 
XXXXXXXXX 1000 UPGRADE 4.2 
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VIEW 


Purpose 


Syntax 


Using VIEW 
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Use to view a file from the NetWare server console. 


VIEW does not let you create or modify files. To create or modify a file, use the 
EDIT NLM program. See “EDIT” 


LOAD VIEW [filename ] 





Parameter Use to 





filename Specify a file to view. 





If you do not specify a filename, VIEW prompts you for the name. 


VOLUME 





VOLUME 


Purpose 


Syntax 


Using VOLUME 


Use at the server console to list mounted volumes. 


CD-ROM volumes are not displayed by this command. For more information, 
see “CD” on page 27 


VOLUME [name ] 








Parameter Use to 

(no parameter) List general information about all mounted 
volumes. 

name Specify the volume you want to display 


information about. 





When you execute VOLUME without the name parameter, a message similar 
to the following appears: 


Mounted Volumes Name Spaces Flags 
SYS DOS Cp Sa Mg 


The output lists each mounted volume, its name spaces, and the flags that are 
set for that volume. The three possible flags are: 


Cp—indicates that file compression is enabled on the volume 
Sa—indicates that block suballocation is enabled on the volume 
Mg—indicates that migration is enabled on the volume 
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When you execute VOLUME name , the screen displays more detailed 
information about the specific volume, such as the following: 


Figure 2-22 
Volume Information 
Volume SYS information: 


Block Usage: 4 FAT blocks, 34 Directories blocks, 0 EDS blocks 
Blocks: 1569 used of 4084 Directory Entries: 1314 used of 2176 
EDS: 0 used of 0 extants Extended Attributes: 0 

Data Streams: 590, 668 (Cp), 9 (Cp Limbo), 242 (Cant Cp) 

Sub Alloc Blocks: 321 

NameSpaces: DOS Flags: Cp Sa 
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VREPAIR 


Purpose 


Syntax 


Using VREPAIR 


Use at the server console to 
@ Correct volume problems 
@ Remove name space entries from Directory tables 


You can’t use VREPAIR on a volume that is mounted. 


LOAD [path ]VREPAIR [volume name ] [log filename ] 








Parameter Use to 

path Specify the path to VREPAIR.NLM if you 
moved it from the default directory. 

volume name Specify the name of a volume to repair. 

log filename Specify a text filename to log errors into. 





@ See”“VREPAIR Options” for an explanation of the VREPAIR main 
menu. 


@ Ifa volume fails to mount when the server is brought up, 
VREPAIR loads automatically and tries to repair the failed 
volume. 


If you don't want VREPAIR to automatically repair a volume that 
won't mount, load SERVMAN or MONITOR, select Server 
Parameters and then Miscellaneous, then set the Automatically 
Repair Bad Volume parameter to OFF. (For more information, see 
“SERVMAN” or “MONITOR” ) 
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How VREPAIR Works 


When to Use VREPAIR 
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@ Use the version of VREPAIR that matches the operating system. 
(You can’t use a NetWare 4 version of VREPAIR on a NetWare 3 
volume.) 


@ The majority of all problems fixed by VREPAIR are caused by 
hardware failures. If a volume frequently needs repair, consider 
replacing the hard disk or controller. 


Copy VREPAIR.NLM and the VREPAIR name space support modules 
(V_NAMESPACE.NLM ) to the boot partition of your server. Then, if volume 
SYS: fails to mount, you can load and run VREPAIR from the DOS boot 
directory. 


Minor problems can occur on a volume if the primary File Allocation Table 
(FAT) or Directory Entry Table (DET) becomes corrupted. 


VREPAIR compares the primary tables with their mirrored counterparts. (The 
operating system keeps two copies of all tables. If hard disks are mirrored, then 
four copies are kept.) 


VREPAIR checks the sets of mirrored tables for errors. If it finds 
inconsistencies, it uses the most correct table entry as the corrected entry. 
VREPAIR then writes the corrected entry to both the primary and mirrored 
tables. 


VREPAIR may have to delete some corrupted files or tables. For more 
information, see “Viewing Deleted Files” 


VEPAIR will log bad block information into a file if you specify a log filename 
when you load VREPAIR. You can also specify a log filename after you load 
VREPAIR, when VREPAIR displays an error. 


VREPAIR can repair a bad volume that you have dismounted while other 
NetWare server volumes are functioning. After you finish running VREPAIR, 
you can mount the repaired volume (in most cases). 


Use VREPAIR when 


VREPAIR 





VREPAIR Options 


@ A hardware failure either prevented a volume from mounting or 
caused a disk read error. 


Although VREPAIR can't fix hardware problems, it can sometimes fix related 
volume damage. 


@ A power failure corrupted a volume. 


@ The server displays memory errors and can’t mount a volume 
after a name space (such as Macintosh) is added to the volume. 


For this type of problem, either add more memory to the server or 
use VREPAIR to remove the newly added name space. 


@ The volume has bad blocks. 


The following kinds of errors in FATs or Directory tables signal 


bad blocks: 

+ Read errors 

+ Data mirror mismatch errors 
¢ Multiple allocation errors 

+ Fatal DIR errors 

+ Write errors 


This information is reported in the log file. 


The VREPAIR main screen displays the following menu: 


Options: 


1 - Repair a volume 
2 - Set VRepair options 


3 - Exit 
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VREPAIR 
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Main Menu Selection Use to 





Repair a volume Begin or continue with volume repair. You can 
also use this option to stop a volume repair in 
process or change the method of displaying 
errors during the repair. 


Set VRepair options Set VREPAIR configuration options. 


Exit Exit VREPAIR. 





In the Set VREPAIR Options menu, there are two settings for each option, a 
default option and an alternate option. When VREPAIR autoloads and tries to 
repair a volume that will not mount, the default settings are used. 


You can configure the VREPAIR alternate options by selecting the associated 
option number to toggle between the alternate and default options. 


For example, option 2 settings are Write All Directory And FAT Entries Out To 
Disk and Write Only Changed Directory And FAT Entries Out To Disk. 


The default for option 2 is Write Only Changed Directory And FAT Entries Out 
To Disk. If you select option 2, your current VREPAIR configuration reflects 
the change from the default to the new setting: Write All Directory And FAT 

Entries Out To Disk. 


The VREPAIR configuration options are described in Table 2-27 . 


VREPAIR 





Table 2-27VREPAIR Configuration Options 
Default Option Alternate Option 


Explanation 





1. Quit ifa VREPAIR Name Remove Name Space 
Space Support NLM is Not Support From The Volume 
Loaded 


2. Write Only Changed Write All Directory And FAT 
Directory And FAT Entries Entries Out To Disk 
Out To Disk 


These options control whether name space 
support for non-DOS files is retained in the 
volume tables. 


If you add a name space to a volume and 
the system doesn’t have enough memory, 
select Remove Name Space Support From 
the Volume. Then select a name space to 
delete. 


If you remove a name space, the 
accompanying extended file information is 
destroyed. 


For example, if you remove Macintosh 
name support, the Macintosh long names, 
the finder icons, and the resource forks are 
destroyed. 


(The DOS name and its data file are kept 
and are accessible from DOS workstations.) 


Important: To repair a volume with non- 
DOS name space entries, VREPAIR must 
find the corresponding name space support 
modules. (For example, to repair a volume 
with the Windows 95/98, or Windows NT 
name space, load V_LONG.NLM.) 


For more information on removing name 
space entries, see Repairing Volumes in 
Supervising the Network . 


These options control the changes that are 
made to the FATs and Directory tables. 


If you repair a mirrored or duplexed volume, 
select the alternate option to force an 
update of all tables on both hard disks. 
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Default Option Alternate Option Explanation 

3. Write Changes Keep Changes In Memory NetWare 4 defaults to writing changes 

Immediately To Disk For Later Update immediately to disk. In most cases, this 
default option speeds the repair. 
Disks requiring very few changes will repair 
faster if the alternate option is used. 

4. Retain Deleted Files Purge All Deleted Files These options control whether deleted files 


5. Return to Main Menu 


Displaying Errors During Repair 


are purged or retained. 


If a file is deleted, but not purged, it can be 
salvaged. 


Purge deleted files if you are concerned 
about the amount of disk space being used 
to retain deleted files or if you don’t want 
users to salvage files (for example, for 
security reasons) 


After you select the VREPAIR configuration 
options, press menu item 5 to return to the 
VREPAIR main menu. 


There are run-time options you can modify during the VREPAIR process to 
change the way errors are displayed. To view the options, select the main menu 


option Repair a volume. 


@ Select Option 1 if you do not want VREPAIR to pause after each 


error. 


@ Select Option 2 if you want VREPAIR to log errors in a text file. 


@ Select Option 3 to stop the repair of the volume. 


@ Select Option 4 to continue with a volume repair after you have 
temporarily suspended the repair. 
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Viewing Deleted Files 


The repair operation can create new files containing data that VREPAIR 
deleted. You can access these files if you select the default configuration option 
Retain Deleted Files. The files are numbered and named VRNNNNNN. FIL 
where N is any number. 


These numbered files are created in any of the following circumstances: 


@  VREPAIR found a filename that has an invalid DOS name. The 
filename might contain invalid characters or might be too long. 


@ VREPAIR found that the filename is not unique. (Another file 
exists with the same name.) 


@ VREPAIR found a FAT chain without a file showing ownership of 
it. 


A file is divided into a series of data blocks that are linked together in a FAT 
chain. 


@ No files in the Directory Entry Table (DET) claimed ownership of 
the data, so a new filename was generated to point to this data. 


VREPAIR might create as many as several thousand of these files. These 


numbered files are created in the directory where they were found during the 
volume repair operation. 


Recovering Files 


You might be able to recover some or all of the files deleted by VREPAIR. 
Contact Technical Support for more information. 


Additional Information 








Topic See 

Repairing a volume or Repairing Volumes in Supervising the Network 
removing name space 

entries 
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Topic See 





Setting VREPAIR options Repairing Volumes in Supervising the Network 
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WHOAMI 





WHOAMI 








Purpose 
Use at a workstation to view connection information. 
Syntax 
WHOAMI [servername ] [/option ...] [/? | /VER] 

Parameter Use to 

servername Replace with the server name whose 
connection information you want to see. 

/option Replace option with any available option. See 
“WHOAMI Options” 

/? View online help. All other parameters are 
ignored when /? is used. 

/VER View the version number of the utility and the 
list of files it uses to execute. All other 
parameters are ignored when /VER is used. 

Using WHOAMI 


WHOAMI displays the following information when no parameters are entered. 


+ 


If you are logged in to Novell Directory Services, you see 


+ 


+ 


The current tree name 
Your other names 
Your titles 

Your description 


Your User ID (name) on each server to which you are 
attached 
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+ The name and version information of each server 
+ The server’s connection number for your connection and the 
type of the connection (Bindery or Directory Services) 
+ The date and time when you logged in to the server. 
@ Ifyou are attached to a server in bindery mode, you see 
¢ Your workgroup manager 
e Your security equivalences 
+ Groups to which you belong 
e Your bindery object’s supervisor 
+ Your rights to files and directories on the server 
Option Use to 
/C (Continuous) Scroll output continuously. 
/ALL (All) View all information. 
/G (Group) View the groups you belong to (bindery). 
/O (Object Supervisor) View the supervisor of the object (bindery). 
/R (Right) View effective rights (bindery). 


/S (Security Equivalences) View security equivalences of the object 


(bindery). 


/W (Workgroup Manager) View the workgroup manager of the object 


(bindery). 





WHOAMI 





Additional Information 


Topic See 





Security Security in Concepis . 
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WSUPDATE 


Purpose 
Use at a workstation to update a file on multiple drives and subdirectories. 


The files that are to be copied to the workstation must reside in the same 
directory on the server as the WSUPDATE utility (the default is SYS:PUBLIC). 
Each workstation you want to udpate files on must have a drive mapped to the 
directory where the utility and files are stored. 


Syntax 


WSUPDATE [<source path > [drive letter: | volume name 
:] [path \filename ] [/option ...]] | [/? | /VER] 


Parameter Use to specify 





source path The path of the file you are updating from, 
including the filename. You can’t use wildcard 
characters. 


drive letter A directory to search for outdated files. 


To search all mapped drives, use the /ALL 
option. 


To search all local drives, use the /Local option. 
volume name An NDS Volume object. 


To search an NDS volume for outdated files, 
enter the full Volume object name relative to 
your current context. 


To search all mapped drives, use the /ALL 
option. 


To search all local drives, use the /Local option. 


path \filename A specific path, including the filename, so the 
search does not begin at the root. 
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Using WSUPDATE 


WSUPDATE Options 








Parameter Use to specify 

/option Replace option with any available option. See 
“WSUPDATE Options” 

/? View online help. 


/VER View the version number of the utility and the 


list of files it uses to execute. 








@ Use to update workstation files from the server. 

@ WSUPDATE compares the date and time of the source and 
destination files. If the source file is more current, WSUPDATE 
updates the destination file. 

@ Ifyou update a file, but want to keep a copy of the old one, use the 
/R option. 

@ WSUPDATE can be run from a batch file. In that case, you may 
want to use options such as /L, /F, or /P. 

Option Use to 

/ALL Search all mapped drives. You can't specify a 

drive or volume with this option. 

/C Copy the new file over the old one, with no 

backup of the old file. 

/CON Continuously scroll the output. 

/E Erase the existing log file. Use with the /L 


option. 
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Option 





Use to 





/F=[path\file ] 


/LOCAL 


/L=[path\file ] 


/N 


/P 


/O 


/R 


IS 


Specify an ASCII file that contains a list of 
target files to be updated. The ASCII file and 
the files to be updated must be in the same 
directory. All other options are ignored when 
you use this option. 


Search all local drives. You can’t specify a drive 
or volume with this option. 


Specify the location and filename of a log file 
where WSUPDATE can store information. The 
log file can be erased with the /E option or with 
a DOS delete command. 


Create the directory specified by the 
destination drive and path. 


Get a prompt asking you whether to proceed. If 
there are no files to be updated, this option 
allows you to abort the session before it begins. 


Tell WSUPDATE to update all files, even those 
flagged Read Only. 


Rename the old file with an .OLD extension 
before copying the new file. 


Specify that WSUPDATE should search for the 
outdated files in all subdirectories of the 
destination path. 





WSUPDATE 





Examples 





Option Use to 





/V[=path | Update the CONFIG.SYS file in the root 


directory of the C: drive with the string 
LASTDRIVE=Z. If your CONFIG.SYS file is 
not in the root of drive C:, then type the path up 
to, but not including, the filename. 


If the CONFIG.SYS file already has a 
LASTDRIVE= parameter, it is replaced with 
LASTDRIVE=Z. 


If your CONFIG.SYS file doesn’t have a 
LASTDRIVE= parameter, WSUPDATE will add 
one. 





To search all mapped drives and copy over old NET5.COM files, 
type 


WSUPDATE VOL:SYSTEM\NET5.COM /ALL /C 
To search local drives and rename the old NET5.COM files, type 
WSUPDATE VOL:SYSTEM\NET5.COM /LOCAL /R 


To update a group of files all in the same directory, place the 
filenames in an ASCII file and use the /F option. For example, 


WSUPDATE /F=C: \NWCLIENT\UPDATES. UPD 
To update the CONFIG.SYS file in the root of drive C:, type 
WSUPDATE /V 


To update the CONFIG.SYS file in the ODI directory on drive C:, 
type 


WSUPDATE /V C:\ODI 


Chapter 2: Utilities 473 


WSUPDATE 





Additional Information 


Topic See 





Using WSUPDATE in login The Novell Client documentation 
scripts 
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WSUPGRD 





Purpose 
Use at a workstation to upgrade the IPX LAN driver on the workstation to the 
corresponding ODI driver. 
Syntax 
WSUPGRD [path ] [/option ...] [/? | /VER] 
Parameter Use to 
path Specify the path to and including the existing 
IPX driver name. Default: \IPX.COM. 
/option Replace option with any available option. See 
“WSUPGRD Options” 
/? View online help. All other parameters are 


ignored when /? is used. 


/VER View the version number of the utility and the 
list of files it uses to execute. All other 
parameters are ignored when /VER is used. 
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WSUPGRD Options 


Option 


Use to 





/C 


/N 


/EO | E1 | E2 
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Cause the utility to exit with error level 1 if no 
upgrade is performed. 


By default, the utility exits with no error code 
whether or not an upgrade is performed. 


This allows a batch file to conditionally perform 
other upgrade actions. 


If an error occurs, the utility exits with an error 
level 3, whether or not /C is specified 


Cause the utility to not delete the IPX driver. 


By default the old driver is deleted before the 
ODI driver is installed. 


Note: If /N is specified and the ODI driver has 
the same name as the IPX driver, the former 
will overwrite the latter—deleting it even if /N is 
specified. 


Control the changes that the utility makes to 
the AUTOEXEC.BAT file. 


Default: E2. 


E0: Specify that no changes be made to the 
AUTOEXEC.BAT file. 


E1: Specify that the line which loads the IPX 
driver is to be deleted (if it is present) from the 
AUTOEXEC.BAT file and replaced by lines to 
load the LSL, ODI driver, and the IPX driver. 


E2: Specify that the line that loads the IPX 
driver is to be deleted (if present) from the 
AUTOEXEC.BAT file and replaced by a call to 
a new batch file called NWSTART.BAT which is 
to be created to load the LSL, the ODI driver, 
and IPX. 


WSUPGRD 








Option 


Use to 





IS 


/l 


Examples 


Suppress the generation of a NET.CFG file 
from the information in the IPX driver’s 
configuration table. 


Note: A NET.CFG file may be generated even 
if this switch is present if an LDC file is present 
with the ODI driver. 


Cause the utility to print out the hardware ID in 
the master configuration table of the ODI 
driver. 


You cannot use this option with any other 
option. 


If this switch is specified, no upgrade is 
performed and thus no other switches are 
allowed. 


@ To save the IPX driver and update the AUTOEXEC.BAT file, type 


WSUPGRD NE2000 /N /E1 


@ To print out the hardware ID, type 


WSUPGRD NE2000 /I 


@ To specify the location of the IPX driver for upgrading, type 


WSUPGRD NE2000 C:\NE2000.COM 
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appendix 


A LAN Driver Statistics 


Monitoring Network Traffic 


By comparing information about LAN drivers installed on your server, you can 
tell which cabling system is handling the most traffic. 


If errors occur frequently on a high-traffic system, you may want to switch 
some of the stations on the busy system to a new or less busy cabling system. 


For information on how to view LAN driver statistics, see Viewing LAN 
Driver Statistics in Supervising the Network . 


Common LAN Driver Statistics 


The generic statistics common to most of the drivers are maintained by two 
modules in the NetWare operating system that are autoloaded by LAN drivers. 
The modules are: 


@ The Media Support Module™ (MSM.NLM) 


@ The Topology Specific Module™ (TSM.NLM) 


There are four TSMs. The one that is autoloaded will depend on 
your server’s LAN driver. The four are: ETHERTSM (Ethernet), 
RXNETTSM (ARCnet), TOKENTSM (token ring), and FDDITSM. 


For more information on the MSM and the TSMs, see Open Data-Link 
Interface in Concepts . 


These common LAN driver statistics can be viewed with MONITOR. Select 
the LAN/WAN Information option from the MONITOR menu, and then select 
a driver. The system displays a window containing both the generic and custom 
statistics for the selected driver. 
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Brief descriptions of the statistics maintained by the MSM and each of the 
TSMs are found in the following tables: 


@ Table B-28 , LAN Driver Statistics 


@ Table B-29 , Generic Statistics for Ethernet Drivers That Use 
ETHERTSM.NLM 


@ Table B-30 , Generic Statistics for RX-Net Drivers That Use 
RXNETTSM.NLM 


@ Table B-31 , Generic Statistics for Token Ring Drivers That Use 
TOKENTSM.NLM 


@ Table B-32 , Generic Statistics for FDDI Drivers That Use 
FDDITSM.NLM 


Custom LAN Driver Statistics 
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Custom statistics describe LAN activity for specific LAN device drivers. 


The custom LAN driver statistics can be viewed with MONITOR. Select the 
LAN/WAN Information option from the MONITOR menu, and then select a 
driver. The system displays a window containing both the generic and custom 
statistics for the selected driver. 


Brief descriptions of statistics for selected drivers are found in the following 
tables: 


@ Table B-33 , Custom Statistics for Ethernet Drivers 
@ Table B-34 , Custom Statistics for Token Ring Drivers 
@ Table B-35 , Custom Statistics for IBM Baseband PCN2L Drivers 


Custom statistics vary, depending on the LAN driver installed. For statistical 
information about third-party drivers, check the documentation that comes with 
the driver. 


If your network board is not listed in the custom statistics section, contact the 
manufacturer of the board and its driver for custom statistics documentation. 


Table B-28LAN Driver Statistics 


Statistic Description 





Driver Name The driver name and parameters that correspond to the 
hardware settings on the network board. 


Version The current version of the driver. 


Node Address The station or node address of the network board in the 
NetWare server. 


Protocols The communication protocols bound to the driver with BIND. 


Network Address The network number assigned to the cabling system the LAN 
driver is operating on. Appears only if the IPX protocol has 
been bound to the board. 


Total Packets Sent The number of packets sent from the NetWare server through 
this LAN driver since the server was last booted. 


(By comparing this figure with the figures for other LAN 
drivers, you can see which driver is handling the most traffic.) 


This value is maintained by the TSM. 


Total Packets Received The number of packets received by the NetWare server since 
it was last booted. This includes file service requests, packets 
routed to another network, and packets sent to other IPX 
sockets in the NetWare server. 


This value is maintained by the TSM. 
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Statistic 


Description 





No ECB Available Count 


Send Packet Too Big Count 


Reserved 


Receive Packet Overflow Count 


Receive Packet Too Big Count 
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A counter that is incremented when a device sends a packet 
to your NetWare server, but no packet receive buffer is 
available. 


The server allocates more packet receive buffers after each 
incident until it reaches its maximum limit (configured with a 
SET parameter). 


If you are using an EISA or microchannel bus-master board 
(such as the NE3200), you will probably need to increase both 
the minimum and maximum number of packet receive buffers. 


See Minimum Packet Receive Buffers and Maximum Packet 
Receive Buffers in “SET” on page 310 


No ECB Available Count messages can also indicate that the 
driver is not configured correctly or that the TSM and the 
Hardware Specific Module (HSM) are incompatible. 


This value is maintained by the TSM. 


A counter that is incremented when the NetWare server tries 
to transmit a packet that is too large for the hardware to 
handle. 


This value is maintained by the TSM. 
This field is not currently used. 


The LAN driver uses this counter to indicate the number of 
times the adapter's receive buffers overflowed, causing 
subsequent incoming packets to be discarded. 


This value is a counter that is incremented when the NetWare 
server receives a packet that is too big to store in a cache 
buffer. 


This happens rarely, unless you are running a software 
program that does not negotiate packet size. Contact the 
vender for an updated version of the software. 


This value is maintained by the HSM. 


A counter that is incremented when the NetWare server 
receives a packet that is too big for the provided receive 
buffers. 


This value is maintained by the TSM. 


Statistic 





Description 





Receive Packet Too Small Count 


Send Packet Miscellaneous 


Errors 


Receive Packet Miscellaneous 
Errors 


Send Packet Retry Count 


Checksum Errors 


Hardware Receive Mismatch 
Count 


Total Send OK Byte Count Low 


Total Send OK Byte Count High 


Total Receive OK Byte Count Low 


A counter that is incremented when the NetWare server 
receives a packet that is too small. 


Currently only the RX-Net TSM maintains this counter. 


A counter that is incremented when errors with send packets 
occur. 


This value is maintained by the HSM. 


A counter that is incremented when errors with receive 
packets occur. This value is maintained by the HSM. 


A counter that is incremented when the NetWare server tries 
to send a packet but fails because of a hardware error. 


The server tries to send the packet until either it succeeds or 
the retry setting is reached. 


This value is maintained by the HSM. 


A counter that is incremented when the checksum byte at the 
end of the packet does not match the sum of the bytes 
contained in the packet. 


This indicates a data error. 


This value is maintained by the HSM. 


A counter that is incremented when the packet length received 
by the hardware and the length specified by the packet do not 
match. 


Currently only the Ethernet TSM maintains this counter. 


The number of bytes, including low-level headers, 
successfully transmitted. 


This value is maintained by the TSM. 


Upper 32 bits of the Total Send OK Byte Count Low. The Total 
Send OK Byte Count High statistic is incremented to 1 when 
the Total Send OK Byte Count Low counter reaches 4 GB. 


This value is maintained by the TSM. 


The number of bytes, including low-level headers, 
successfully received. This value is maintained by the TSM. 
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Statistic 


Description 





Total Receive OK Byte Count High 


Total Group Address Send Count 


Total Group Address Receive 
Count 


Adapter Reset Count 


Adapter Operating Time Stamp 


Adapter Queue Depth 
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Upper 32 bits of the Total Receive OK Byte Count Low. 


The Total Receive OK Byte Count High statistic is 
incremented to 1 when the Total Receive OK Byte Count Low 
value reaches 4 GB. 


This field is maintained by the TSM. 


The number of packets transmitted with a group or multicast 
destination address. This field is maintained by the TSM. 


The number of packets received with a group or multicast 
destination address. This field is maintained by the TSM. 


The number of times the adapter was reset because of 
internal failures or other calls to the Driver Reset routine. 


This field is maintained by the HSM. 


The time stamp indicating when the adapter last changed 
operational state (such as load, shutdown, or reset). 


This value is maintained by the MSM. 


The number of transmit packets (transmit ECBs) that are 
queued for the adapter. 


This is an indication of throughput overload on transmits. 


This field is maintained by the TSM. 


Table B-29Generic Statistics for Ethernet Drivers That Use ETHERTSM.NLM 


Statistic 


Description 





Send OK Single Collision Count 


Send OK Multiple Collision Count 


Send OK But Deferred 


Send Abort From Late Collision 


Send Abort From Excess 
Collisions 


Send Abort From Carrier Sense 





The number of frames involved in a single collision that are 
subsequently transmitted successfully. 


When the Ethernet controller detects a collision, it backs off 
and then retries the transmission. 


The number of frames involved in more than one collision that 
are transmitted successfully. 


This happens if the Ethernet controller had to back off more 
than once due to collisions. 


The number of frames whose transmission was delayed 
because of a busy medium. 


This happens if another station is transmitting on the wire 
when the adapter receives the command to transmit a packet. 


The number of transmits that had a collision after 512 bits of 
the packet were transmitted. 


This can be caused by faulty adapters, faulty network 
equipment, cables that are too long, or faulty terminators. 


The number of transmits that were aborted because of too 
many collisions. 


This usually indicates that a board in the network is bad or 
jabbering. (Jabbering means the board has been on the 
channel longer than the time needed to transmit the maximum 
size packet.) 


This condition could also occur in very heavy traffic 
conditions. 


The number of transmits aborted because of loss of carrier 
sense while transmitting without any collisions. 


This is usually caused by a faulty adapter in the network, faulty 
cabling, an unterminated cable, or a faulty repeater. 
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Statistic 


Description 





Send Abort From Excessive 
Deferral 


Receive Abort From Bad Frame 
Alignment 
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The number of transmits aborted because of excessive 
deferrals. 


This is usually caused by a faulty adapter or repeater in the 
system that is jabbering on the wire. 


It can also occur under very heavy traffic conditions. 


The number of received frames that were misaligned. 


This occurs when the number of octets in the frame is not 
correct or the frame does not pass the FCS check. 


These bad packets are usually caused by a faulty adapter or 
repeater in the system. They can also be caused by a 
collision. 


Table B-30Generic Statistics for RX-Net Drivers That Use RXNETTSM.NLM 


Statistic Description 





NoResponseToFreeBufferEnquiry A counter that is incremented each time there is no response 
from the receiving node to a Free Buffer Enquiry. 


NetworkReconfigurationCount A counter that is incremented each time a Network 
Reconfiguration occurs. 


InvalidSplitFlagInPacketFlag A counter that is incremented each time the Split Flag in the 
packet fragment is not the value expected. 


Packet fragments received out of order can cause this value 
to increase. 


OrphanPacketFragmentCount A counter that is incremented each time a packet fragment is 
received that is not a part of a previously received packet and 
therefore cannot be appended. 


ReceivePacketTimeout A counter that is incremented each time a received packet 
times out while waiting for the rest of the packet fragments to 
arrive. 

FreeBufferEnquiryNAKTimeout A counter that is incremented each time a transmit packet 


times out while waiting for an acknowledgment to a Free 
Buffer Enquiry from the receiving node. 


TotalSendPacketFragmentsOK A counter that is incremented each time a packet fragment is 
sent successfully. 


This number is high because packets are made up of multiple 
fragments. 


For example a 4-KB packet is actually eight 512-byte packet 
fragments. 


TotalReceivePacketFragmentsOK A counter that is incremented each time a packet fragment is 
received successfully. 


This number is high because packets are made up of multiple 
fragments. 


For example a 4-KB packet is actually eight 512-byte packet 
fragments. 
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Table B-31Generic Statistics for Token Ring Drivers That Use TOKENTSM.NLM 


Statistic 


Description 





AC Error Counter 


Abort Delimiter 


Burst Error Counter 


Frame Copied Error Counter 


Frequency Error Counter 


Internal Error Counter 


Last Ring Status 


Line Error Counter 
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This counter is incremented when a ring station receives a 
Standby Monitor Present MAC frame with the A/C bits in the 
Frame Status field equal to zero without first receiving an 
Active Monitor Present MAC frame. 


This counter is incremented when a ring station transmits an 
abort delimiter. 


An abort delimiter is transmitted when a ring station receives 
a frame in which the token bit of the access control field is set 
to show Token and not Frame. 


A ring station can also transmit an abort delimiter if an internal 
hardware error has occurred. 


This counter is incremented when a ring station detects the 
absence of five half-bit times (a burst-five error). 


Other stations will detect a burst-four error followed by idles. 


This counter is incremented when a ring station recognizes 
(receives or repeats) a frame addressed to its specific 
address and detects that the FC field A bits are set to 1, 
indicating a possible line hit or a duplicate address. 


This counter is incremented when the frequency of the 
incoming signal differs from the expected frequency by more 
than that specified in Section 7 of IEEE Standard 802.5-1989. 


This counts the times a ring station has a recoverable internal 
error, which means a ring station is probably marginal. 


This code changes each time the ring status changes. Status 
codes are reported by the physical hardware. 


See the /BM Token-Ring Network Architecture Reference for 
the status code, function, and meaning. 


This counter is incremented when a frame or token is 
repeated by the ring station. 


A frame is repeated when a Frame Check Sequence error 
occurs or a code violation exists between the starting and 
ending delimiters of the frame. 





Statistic Description 





Lost Frame Counter This counter is incremented when a ring station transmits a 
frame that does not return to the station. 


The active monitor sends a new token. 
Token Error Counter This counter is incremented when a station acting as the 


active monitor recognizes an error condition that needs a 
token transmitted. 


This occurs when the TVX timer expires. 


Up Stream Node High Dword The first eight digits of the Up Stream node address of the next 
node up stream on the ring. 


Up Stream Node Low Dword The next four digits of the Up Stream node address of the next 
node up stream on the ring. 


Last Ring ID This contains the value of the local ring ID. 


Last Beacon Type This contains the value of the last beacon type. 
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Table B-32Generic Statistics for FDDI Drivers That Use FDDITSM.NLM 


Statistic Description 





Configuration State The attachment configuration for the station or concentrator: 


O=isolated; 1=local_a; 2=local_b; 3=local_ab; 4=local_s; 
5=wrap_a; 6=wrap_b; 7=wrap_ab; 8=wrap_s; 9=c_wrap_a; 
10=c_wrap_b; 11=c_wrap_s; 12=thru 





Upstream Node Address The upstream neighbor's MAC address (0 if unknown). 
Downstream Node Address The downstream neighbor's MAC address (0 if unknown). 
Frame Error Counter The number of frames that were detected in error by this MAC 


that had not been detected in error by another MAC. 


Frames Lost Counter The number of instances that this MAC detected a format 
error during frame reception such that the frame was stripped. 


Ring Management State Indicates the current state of the Ring Management state 
machine: 


0=lsolated; 1=Non_Op; 2=Ring_Op; 3=Detect; 
4=Non_Op_Dup; 5=Ring_Op_Dup; 6=Directed; 7=Trace 


LCT Failure Counter The count of the consecutive times the link confidence test 
(LCT) has failed during connection management. 


LEM Link Reject Counter The link error monitor (LEM) count of the times that a link was 
rejected 

LEM Error Counter The aggregate link error monitor (LEM) error count. 

Connection State The state of this port’s Physical Connection Management 


(PCM) state machine: 


0=Off; 1=Break; 2=Trace; 3=Connect; 4=Next; 5=Signal; 
6=Join; 7=Verify; 8=Active; 9=Maint 








Table B-33Custom Statistics for NE2000, NE2, NE2_32, NE1000, and Other Ethernet Drivers 


Statistic Description 





UnderrunErrorCount This counter is incremented when the RAM buffer on the 
network board is full; the board cannot accept any more 
packets until the RAM buffer is cleared. 
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Statistic 





Description 





TransmitTimeoutCount 


RxPagingErrorCount 


ReceiveFlFOOverrunErrorCount 


ReceiverMissedPacketCount 


GotNothingCount 


UnsupportedFramePacketCount 


UnsupportedMulticastCount 


BackToBackSendCount 


EnqueuedSendCount 


This counter is incremented when a network board interrupts 
the file server with the message that the send bit is lost. 


This is a hardware problem caused by faulty cabling, a bad 
network board, or a missing terminator. 


This is a count of the errors that occur when internal buffers 
on the card are corrupted. 


This counter is incremented when an incoming packet causes 
an overflow because FIFO was not serviced. 


This counter is incremented when a packet is sent to a 
network board that cannot accept the packet because all its 
receive buffers are full. 


This counter is incremented when the file server receives an 
interrupt from a network board that is not transmitting or 
receiving anything. 


This is not serious. 


This counter is incremented when a packet is received by the 
LAN driver with a frame type that hasn't been loaded for the 
given board. 


This counter is incremented for each multicast packet 
received by the board that is not registered with the driver. 


This counter is incremented each time the driver can buffer a 
send packet onto the network board while the board is 
sending a previous buffer. 


Use this counter to track congestion on the network board. 


See also EnqueuedSendsCount. 


This counter is incremented when the driver is unable to 
transmit a packet and must put the packet in a queue until the 
transmitter is available. 


Use the counter to track congestion on the network board. 


See also BackToBackSendCount. 
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Statistic 


Description 





In32BitModeCount 


HeartBeatError 


MemoryTimeout 


TxBabblingError 


TxUnderflowError 
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(NE1000 only) This counter is incremented if a network board 
is ever found in 32-bit mode. 


(Currently, workstations run in 8-bit mode.) 


Occasionally, older NE1000 boards have bad chips that make 
the boards go into 32-bit mode. 


If this counter is ever incremented, there is probably an older 
board on the network. 


(NE2100 or NE1500T) This counter is incremented when 
there is a signal quality error. 


This function is also known as the heartbeat or Signal Quality 
Error (SQE) test. 


This counter indicates a hardware problem. 


(NE2100 or NE1500T) This counter is incremented when 
there is contention on the bus. 


If this counter is incremented, there may be multiple boards in 
the server or another bus-mastering device in the server, such 
as a LAN or disk channel device. 


(NE2100 or NE1500T) This counter is incremented when 
there is excessive length in the transmit buffer. 


It will increment after 1519 data bytes have been transmitted 
from the buffer. 


It indicates that the transmitter has been on the channel 
longer than the time required to send the maximum length 
packet. 


If this counter is incremented, it indicates a hardware problem 
with the network interface card in the server. 


(NE2100 or NE1500T) This counter is incremented when 
something else on the bus takes control of the bus while the 
LAN driver is putting the data on the wire. 


If this occurs, the packet must be retransmitted. 


Statistic 





Description 





TXBufferError 


RxECBsOver1 6MegCount 
TxECBsOver16MegCount 


PacketUsed2ECBs 


(NE2100 or NE1500T) This counter is incremented when 
there is a problem with the transmit buffer. 


This counter is usually incremented when TxUnderflowError 
is incremented; it indicates a hardware problem in the server. 


(NE2100 or NE1500T) One of these counters is incremented 
when either a transmit or receive occurs and the driver has 
double buffered the ECB in the reserved buffers below 16 MB 
in memory. 


These boards require double buffering because they have a 
physical limitation that prevents them from accessing memory 
above 16 MB. 


Therefore, if the operating system issues an Event Control 
Block (ECB) with a memory address above 16 MB, the board 
uses some of the reserved buffers below 16 MB to queue the 
request. 


These are not errors. This value tracks how many ECBs are 
redirected to the buffers below 16 MB. 


In many cases, this counter can be as high as the total 
packets sent and received. This double buffering decreases 
performance. 


If you have more than 16 MB of RAM and a board that is bus- 
mastering or using DMA that is not a 32-bit adapter, 
performance may be degraded. 


(NE2100 or NE1500T) This counter is incremented if the 
Server Maximum Physical Receive Packet Size is set to 1514 
bytes (default for NetWare 3.11 servers), and you need to 
receive a near-full-size packet 


In this instance, two ECBs are used instead of one, since the 
CRC on the end of the packet requires an extra four bytes. 


Using two ECBs instead of one may decrease performance 
slightly. 


Note: For Netware 3.12 and 4.x the default Maximum 
Physical Receive Packet Size is 4202. 
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Statistic 


Description 





TransmitRetryFailure 


TxClearToSendsErrors 


TxDMAUnderrunErrors 


RxDMAOverrunErrors 


RxPacketSlideErrors 





494 Utilities Reference 


(NE3200) This counter is incremented when the driver is 
unable to transmit a packet after a specified number of times. 


This may indicate a hardware problem. 


(NE3200) This counter tracks an 82586 error. 


There are some conditions when the Clear to Send signal 
from the 82586 chip is incorrect. 


This counter indicates the number of times the corrective code 
on the adapter was executed to work around this condition in 
the 82586. 


(NE3200) This counter tracks an 82586 error. 


Contention among the BMIC, 80186, and 82586 can occur on 
the adapter, causing the 82586 to assume it did not receive all 
of the packet for transmission. The transmit operation must 
then be retried. 


This counter indicates the number of times the corrective code 
on the adapter was executed to work around this condition. 


(NE3200) This counter tracks an 82586 error. 


If two packets are received back-to-back at close to 9.6 
microseconds (the minimum Ethernet interframe spacing), 
then the chip may report an overrun. 


If so, the frames are lost by the chip and the source must 
retransmit. 


This counter indicates the number of times this error has 
occurred. 


(NE3200) This counter tracks the number of instances of an 
82586 anomaly. 


In some conditions, the 82586 may be off by two bytes in the 
receive packet descriptors. In this case, the sending station 
must retransmit the packet. 


This counter indicates the number of times this condition has 
occurred. 


Statistic 





Description 





RxDummyRCBUsedErrors 


InternalAdapterReset 


MondoFragmentLengthErrors 


PollingTimeout 


ResetBecauseHardwareDiedErro 
rs 


(NE3200) This counter tracks an 82586 error. 


In some cases, the 82586 may attempt to receive data into a 
nonexistent receive buffer at the end of its receive buffer list. 


To catch this condition and avoid internal data corruption, a 
dummy receive buffer is added to the end of the list. 


This variable counts the number of times the 82586 attempted 
to write into the dummy buffer. 


(NE3200) This counts the number of resets (by the 80186) 
that occurred on the adapter due to failures on the adapter. 


This counter is incremented when the software corrects itself 
for minor problems or if the adapter is in an unknown state. 


It is common for this counter to be incremented. 


Under normal conditions, more of these errors should occur 
during idle time than when the driver is busy. 


This counter would only indicate a hardware problem if it 
registered thousands of these errors when the network is 
busy. 


(NE3200) This counter tracks the number of instances in 
which an NLM on the server has passed the NE3200 driver an 
ECB whose logical memory address could not be translated 
to a physical memory address. 


You should check other NLMs on the system and upgrade 
them. 


If you are still experiencing problems, identify which NLM is 
causing the problem and contact the third-party manufacturer 
of the NLM. 


(NE3200) This counter tracks the number of times the 
adapter’s request was put on the queue but was not serviced 
within 800 nanoseconds (default). 


After this occurs, the adapter fires an interrupt. 


(NE3200) If the adapter is in an unknown state or stops 
transmitting on the host side, the driver increments this 
counter and resets or restarts the adapter. 
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Statistic 


Description 





NumberOflinterruptsFired 


FlFOUnderRunCount 


ByteCountMismatchCount 


HardTransmitErrorCount 


TransmitCollisionsCount 


OutOfWindowCollisionCount 


CRCErrorCount 


FlFOOverrunCount 
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(NE3200) This counter is incremented each time the adapter 
had to fire an interrupt to service a request because the polled 
request wasn’t serviced. 


(NE32HUB) This counter is incremented during high 
utilization or high bus usage if a packet cannot be sent. 


This event should rarely occur. 


(NE32HUB) This counter is incremented when the transmit 
packet size is not equal to the sum of fragments passed to the 
SONIC chip on the board. 


This event should rarely occur. 


(NE32HUB) This counter is incremented when a CRC, 
Excessive Deferral, ByteCount MismatchCount, or 
FlFOUnderRunCount occurs on a transmit. 


This is a general transmit error counter. 


(NES2HUB) This counter is incremented when the board can’t 
transmit on the wire. 


If the board requires five tries to transmit the packet, this 
counter is incremented by 4. 


(NES2HUB) This counter is incremented when an illegal 
collision occurs. 


Collision should normally occur during the preamble. This 
counter is incremented if the collision occurs after the 
preamble. 


This event should rarely occur. 


(NES2HUB) This counter is incremented when a packet with 
a bad CRC is received by the card. 


(NE32HUB) This counter is incremented when a packet with 
errors is received. 


The driver looks at the FIFO overrun counter to determine if 
there are errors. 


If there are errors, the packet is thrown away. 


Statistic 





Description 





RDAExhaustCount 


RRAExhaustCount 


RBAExceedCount 


FlagFoundCount 


PacketsCompressedCount 


RlCAddressWasInvalidCount 


TxTimeOutCount 


(NES2HUB) This counter is incremented when the driver can’t 
take the data out of the buffer fast enough to process it, and 
the Receive Descriptor Area has overflowed. 


This should not happen very often, but it is more likely under 
high utilization. 


(NES2HUB) This counter is incremented when the driver can’t 
take the data out of the buffer fast enough to process it, and 
the Receive Resource Area has overflowed. 


This shouldn't occur very often, but it is more likely to occur 
during high usage. 


(NES2HUB) This counter is incremented when the driver can’t 
take the data out of the buffer fast enough to process it, and 
the Receive Buffer Area has overflowed. 


This shouldn't occur very often, but is more likely to occur 
during high usage. 


(NE32HUB) This counter is incremented when the RIC chip 
on the adapter reports an error such as Jabber, Out of 
Window Collision, etc. 


(NES2HUB) This counter is incremented when the driver is in 
promiscuous mode and is looking at every packet. 


To get management information efficiently, the driver copies 
only the first 50 bytes of the packet into the buffer and then 
adds the 7 bytes of management information to the end of the 
packet. 


This occurs only on the packets that are not destined for the 
server when the driver is loaded with PCOMP=ENABLE 
(default). 


(NE32HUB) This counter is incremented when the RIC 
address was corrupted on a receive management packet. 


The driver expects this number to be correct. 


(NES2HUB) This counter is incremented when a transmit 
doesn’t occur in 2 seconds. 
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Statistic Description 

PortOErrorCount (NE32HUB) This counter is incremented when the port 
address is set to zero. 
The port address should always be between 1 and 12. 
This will not occur frequently. 

PortBigErrorCount (NE32HUB) This counter is incremented when the port 


ValidC RCCount 
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address is above 13. 
The port address should always be between 1 and 12. 


This will not occur frequently. 


(NE32HUB) This counter is incremented when the 
Management Information overlaying the CRC is correct. 


The Management Information should be incorrect. 


This event should rarely occur. 


Table B-34Custom Statistics for Token Ring Drivers 


Statistic 


Description 





Bad Correlator Count 


Unknown ARB requests 


MicroChannel Error Count 


ECBs Over 16Meg 


DMA Bus Errors Count 





(TOKEN, NTR2000) This counter is incremented when a 
network board responds with a request for data from the file 
server that the file server does not have. 


The ECB or some other code may be corrupted. Eventually, 
this error will abend the server. 


If this counter is non-zero, you should try to find the software 
that is corrupting the data. 


(TOKEN, NTR2000) This counts bad Adapter Request Blocks 
(ARBs). 


Normally the network board (adapter) uses one of four known 
commands to communicate with the driver. 


If a network board sends a command that is not one of the 
four, the driver does not recognize the request. 


This error is not a catastrophic error. 


Sometimes old adapters send bad ARB requests because of 
software problems on the board. 


NetWare responds to the network board so that the board will 
not hang. 


(TOKENDMA) This counter tracks the number of times the 
adapter had a problem transmitting on the bus. 


The adapter interrupt occurred from the firmware on the card. 


(TOKENDMA) This counter tracks the number of packets 
received that had to use an ECB over 16 MB. 


This number should only increment when more than 16 MB of 
RAM is used in the server. 


(TOKENDMA) This counter is incremented when a DMA 
transfer completes with a bus error. 


If this counter is incremented, it could indicate a hardware 
problem. 
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Statistic 


Description 





DMA Parity Errors Count 


Command Reject Count 


Tx Timeout Count 


Transmit Late Count 


Transmit Defragment Count 
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(TOKENDMA) This counter is incremented when a DMA 
transfer completes with a parity error. 


If this is incremented, it could indicate a hardware problem. 


(TOKENDMA) This counter is incremented when the driver 
sends a command to the board and the command is either 
invalid or the board is still busy processing the previous 
command. 


This number should be zero or a low number. 


(TOKENDMA) This counter is incremented and the adapter is 
reset if 2 seconds elapse before the driver learns from the 
firmware that the transmit was or wasn’t successful. 


This counter shows the driver is successfully recovering from 
the lost hardware transmit. 


It isn’t a problem if this number is incremented. 


(TOKENDMA) This counter is incremented when the firmware 
reports that the card transmitted more than it actually did. 


After this event occurs, the data that wasn’t transmitted will be 
sent in the next packet. 


This problem is more likely to occur on busier networks. 


(TOKENDMA) This counter tracks how many ECBs are 
redirected to the buffer below 16 MB. 


The IBM Token-Ring DMA LAN boards are not able to access 
memory above 16 MB. Therefore, if the operating system 
issues an Event Control Block (ECB) with a memory address 
above 16 MB, the board uses some of the reserved buffers 
below 16 MB to double buffer the ECB. 


These are not errors. In many cases, this counter can be as 
high as the total packets sent and received. However, this 
double buffering decreases performance. 


If the system has more than 16 MB of RAM and a board that 
is bus-mastering or using DMA that is not a 32-bit adapter, 
performance may decrease. 


Table B-35Custom Statistics for IBM Baseband PCN2L Drivers 


Statistic 


Description 





HotCarrierlnterruptCount 


No82588InterruptCount 


WeirdInterruptCount 


BadTransmitComplete- 
InterruptCount 


HardTransmitErrorCount 


GotNothingCount 


ReceiveUnderrunErrorCount 


ReceivedShortPacketCount 


BadReceiveConditionCodeCount 


(PCN2L) This counter is incremented when the board detects 
a carrier longer than expected without a transmit. 


This indicates that some board on the network has failed or is 
beginning to fail. 


(PCN2L) This counter is incremented each time the server 
receives an interrupt from the board, but not from the 82588 
chip. 


This should very seldom, if ever, happen. 


(PCN2L) This counter is incremented when the server has 
received an interrupt from the board, but the board claims not 
to have sent one. 


This should very seldom, if ever, happen. 


(PCN2L) This counter is incremented for each complete 
transmission with no transmit active. 


(PCN2L) This counter is incremented when a transmit fails 
and the driver retries the transmit. 


(PCN2L) This counter is incremented when the driver 
receives an interrupt from the board indicating that it has 
completed a receive but there is no data in the board’s receive 
buffer. 


This is not serious. 


(PCN2L) This counter is incremented when the driver finds 
less data in the board’s buffer than the board reported. 


(PCN2L) This counter is incremented when a packet of less 
than 17 bytes is received. 


(PCN2L) This counter is incremented when the buffer is 
flushed because the board hasn't received the incoming 
packets properly. 
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Trademarks 


Novell, Inc. has attempted to supply trademark information about company 
names, products, and services mentioned in this manual. The following list of 
trademarks was derived from various sources. 


Novell Trademarks 


Advanced NetWare is a trademark of Novell, Inc. 

Client 32 is a trademark of Novell, Inc. 

EXOS is a trademark of Novell, Inc. 

Hot Fix is a trademark of Novell, Inc. 

Internetwork Packet Exchange and IPX are trademarks of Novell, Inc. 
IntranetWare is a trademark of Novell, Inc. 


LANalyzer is a registered trademark of Novell, Inc. in the United States and 
other countries. 


Link Support Layer and LSL are trademarks of Novell, Inc. 

Media Support Module and MSM are trademarks of Novell, Inc. 
Multiple Link Interface and MLI are trademarks of Novell, Inc. 
Multiple Link Interface Driver and MLID are trademarks of Novell, Inc. 
NE1000 is a trademark of Novell, Inc. 

NE1500T is a trademark of Novell, Inc. 

NE2000 is a trademark of Novell, Inc. 

NE2100 is a trademark of Novell, Inc. 

NE3200 is a trademark of Novell, Inc. 

NE32HUB is a trademark of Novell, Inc. 


NetWare is a registered trademark of Novell, Inc. in the United States and other 
countries. 


NetWare 3 is a trademark of Novell, Inc. 

NetWare 4 is a trademark of Novell, Inc. 

Novell Application Notes is a trademark of Novell, Inc. 
NetWare Client is a trademark of Novell, Inc. 

NetWare Core Protocol and NCP are trademarks of Novell, Inc. 
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NetWare Directory Services and NDS are trademarks of Novell, Inc. 
NetWare Loadable Module and NLM are trademarks of Novell, Inc. 
NetWare Management Agent is a trademark of Novell, Inc. 
NetWare Requester is a trademark of Novell, Inc. 

NetWare SFT III is a trademark of Novell, Inc. 


NetWire is a registered service mark of Novell, Inc. in the United States and 
other countries. 


Network Support Encyclopedia Professional Volume and NSEPro are 
trademarks of Novell, Inc. 


Novell is a registered trademark of Novell, Inc. in the United States and other 
countries. 


Novell Authorized Reseller is a service mark of Novell, Inc. 

Novell Press is a registered trademark of Novell, Inc. in the United States. 
Novell Research Reports is a trademark of Novell, Inc. 

Open Data-Link Interface and ODI are trademarks of Novell, Inc. 

SFT is a trademark of Novell, Inc. 

SFT III is a trademark of Novell, Inc. 

Storage Management Services and SMS are trademarks of Novell, Inc. 
Transaction Tracking System and TTS are trademarks of Novell, Inc. 


UNIX is a registered trademark of X/Open Company, Ltd., in the United States 
and other countries. 


Virtual Loadable Module and VLM are trademarks of Novell, Inc. 


Third-Party Trademarks 
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AT&T is a registered trademark of AT&T Corp. 

Btrieve is a registered trademark of Pervasive Software, Inc. 
CompuServe is a registered trademark of CompuServe Incorporated. 
DynaText is a registered trademark of Electronic Book Technologies, Inc. 
IBM is a registered trademark of International Business Machines Corp. 
Macintosh is a registered trademark of Apple Computer, Inc. 

Microsoft is a registered trademark of Microsoft Corporation 


OS/2 is a registered trademark of International Business Machines 
Corporation. 


Unicode is a registered trademark of Unicode, Inc. 
Windows is a registered trademark of Microsoft Corporation. 
Windows 95 is a trademark of Microsoft Corporation. 


